插件:多语言-获取博客文章翻译
获取指定博客文章的原始数据和多语言翻译数据。编辑前建议先通过 插件:多语言-翻译语言列表 确认翻译语言,修改后通过 插件:多语言-保存博客文章翻译 保存。
接口信息
- 接口地址:
{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}'
返回结果
code 为 200 表示调用成功;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 描述 |
注意事项
article_tranlate 中可能不含某些语言的翻译(语言刚添加或未编辑),UI 应对缺失语言提供空输入框
- 修改翻译时,通过
lang_code 与保存接口对应,不需要传 id
- 编辑完整流程:翻译语言列表 → 本接口获取翻译数据 → 回填 UI → 保存翻译