插件:多语言-获取自定义页面翻译
获取指定自定义页面的原始数据和多语言翻译数据。编辑前建议先通过 插件:多语言-翻译语言列表 确认翻译语言,修改后通过 插件:多语言-保存自定义页面翻译 保存。
接口信息
- 接口地址:
{your-site-url}/api/skill/addons-language/get-page-translate
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
- 请求方式:
GET
- 说明: 获取自定义页面的原始数据(
page_data)以及各语言的翻译数据(page_tranlate)。用于多语言编辑页面——展示基础语言内容,同时加载各语言的已有翻译供修改。
认证
请求头中需要携带 skill-access-token:
| Header |
值 |
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数 (Query)
| 字段 |
类型 |
必填 |
说明 |
page_id |
int |
是 |
自定义页面 ID |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/addons-language/get-page-translate?page_id=388' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"page_data": {
"title": "Top 10 Cross-Border eCommerce SaaS Platforms",
"body_html": "<h2>Top 10 Cross-Border eCommerce...</h2>...",
"meta_title": "Top 10 Cross-Border eCommerce SaaS Platforms 2026",
"meta_keywords": "cross-border ecommerce SaaS 2026",
"meta_description": "Comprehensive guide to the top 10 cross-border eCommerce SaaS platforms."
},
"page_tranlate": [
{
"id": 122,
"shop_id": 15,
"page_id": 388,
"lang_code": "cn",
"title": "2026年十大跨境电商SaaS平台",
"body_html": "<h2>2026年独立站十大跨境电商SaaS平台</h2>...",
"meta_title": "2026年十大跨境电商SaaS平台",
"meta_keywords": "跨境电商SaaS 2026",
"meta_description": "2026年独立站十大跨境电商SaaS平台全面指南。",
"created_at": "2026-06-07 18:12:17",
"updated_at": "2026-06-07 18:12:17"
}
]
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码,200 表示成功 |
message |
String |
执行结果的文字描述 |
data |
Object |
自定义页面翻译数据 |
data 字段
| 字段 |
类型 |
说明 |
page_data |
Object |
页面的默认/基础语言数据 |
page_tranlate |
Array[Object] |
页面各语言的翻译数据 |
page_data 字段(翻译字段)
| 字段 |
类型 |
说明 |
title |
string |
页面标题 |
body_html |
string |
页面内容(HTML 格式) |
meta_title |
string |
SEO 标题 |
meta_keywords |
string |
SEO 关键词 |
meta_description |
string |
SEO 描述 |
page_tranlate 子项字段
| 字段 |
类型 |
说明 |
id |
int |
翻译记录 ID |
shop_id |
int |
店铺 ID |
page_id |
int |
页面 ID |
lang_code |
string |
语言简码。与 插件:多语言-翻译语言列表 的 code 对应 |
title |
string |
翻译后标题 |
body_html |
string |
翻译后内容(HTML 格式) |
meta_title |
string |
翻译后 SEO 标题 |
meta_keywords |
string |
翻译后 SEO 关键词 |
meta_description |
string |
翻译后 SEO 描述 |
created_at |
string |
创建时间 |
updated_at |
string |
最后更新时间 |
涉及的翻译字段
自定义页面多语言翻译涉及以下 5 个字段:
| 字段 |
说明 |
title |
页面标题 |
body_html |
页面内容(支持 HTML) |
meta_title |
SEO 标题 |
meta_keywords |
SEO 关键词 |
meta_description |
SEO 描述 |
注意事项
page_tranlate 中可能不含某些语言的翻译(语言刚添加或未编辑),UI 应对缺失语言提供空输入框
- 修改翻译时,通过
lang_code 与保存接口对应,不需要传 id
- 编辑完整流程:翻译语言列表 → 本接口获取翻译数据 → 回填 UI → 保存翻译