插件:多语言-获取博客文章翻译

获取指定博客文章的原始数据和多语言翻译数据。编辑前建议先通过 插件:多语言-翻译语言列表 确认翻译语言,修改后通过 插件:多语言-保存博客文章翻译 保存。

接口信息

  • 接口地址: {your-site-url}/api/skill/addons-language/get-blog-article-translate
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 获取博客文章的原始数据(article_data)以及各语言的翻译数据(article_tranlate)。用于多语言编辑页面——展示基础语言内容,同时加载各语言的已有翻译供修改。

认证

请求头中需要携带 skill-access-token

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数 (Query)

字段 类型 必填 说明
article_id int 博客文章 ID

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/addons-language/get-blog-article-translate?article_id=481' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code200 表示调用成功;code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "article_data": {
            "title": "Top 10 Cross-Border eCommerce SaaS Platforms",
            "summary_html": "",
            "body_html": "<h2>The Rise of Cross-Border SaaS eCommerce</h2>...",
            "meta_title": "Top 10 Cross-Border eCommerce SaaS Platforms 2026",
            "meta_keywords": "cross-border, ecommerce, SaaS",
            "meta_description": "Discover the top 10 cross-border eCommerce SaaS platforms."
        },
        "article_tranlate": [
            {
                "id": 39,
                "shop_id": 15,
                "article_id": 481,
                "lang_code": "cn",
                "title": "2026年独立站十大跨境电商SaaS平台",
                "summary_html": "",
                "body_html": "<h2>2026年跨境SaaS电商的崛起</h2>...",
                "meta_title": "2026年十大跨境电商SaaS平台",
                "meta_keywords": "跨境电商SaaS,DTC平台对比",
                "meta_description": "探索2026年适用于独立站的10大跨境电商SaaS平台。",
                "created_at": "2026-06-07 17:58:20",
                "updated_at": "2026-06-07 17:58:20"
            }
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Object 博客文章翻译数据

data 字段

字段 类型 说明
article_data Object 文章的默认/基础语言数据
article_tranlate Array[Object] 文章各语言的翻译数据

article_data 字段(翻译字段)

字段 类型 说明
title string 文章标题
summary_html string 文章摘要(HTML 格式)
body_html string 文章正文(HTML 格式)
meta_title string SEO 标题
meta_keywords string SEO 关键词
meta_description string SEO 描述

article_tranlate 子项字段

字段 类型 说明
id int 翻译记录 ID
shop_id int 店铺 ID
article_id int 文章 ID
lang_code string 语言简码。与 插件:多语言-翻译语言列表code 对应
title string 翻译后标题
summary_html string 翻译后摘要(HTML 格式)
body_html string 翻译后正文(HTML 格式)
meta_title string 翻译后 SEO 标题
meta_keywords string 翻译后 SEO 关键词
meta_description string 翻译后 SEO 描述
created_at string 创建时间
updated_at string 最后更新时间

涉及的翻译字段

博客文章多语言翻译涉及以下 6 个字段:

字段 说明
title 文章标题
summary_html 文章摘要(支持 HTML)
body_html 文章正文(支持 HTML)
meta_title SEO 标题
meta_keywords SEO 关键词
meta_description SEO 描述

注意事项

  1. article_tranlate 中可能不含某些语言的翻译(语言刚添加或未编辑),UI 应对缺失语言提供空输入框
  2. 修改翻译时,通过 lang_code 与保存接口对应,不需要传 id
  3. 编辑完整流程:翻译语言列表 → 本接口获取翻译数据 → 回填 UI → 保存翻译
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-07 18:32:42

results matching ""

    No results matching ""