插件:多语言-获取自定义页面翻译

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

接口信息

  • 接口地址: {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}'

返回结果

code200 表示调用成功;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 描述

注意事项

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

results matching ""

    No results matching ""