插件:多语言-获取博客专辑翻译

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

接口信息

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

认证

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

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

请求参数 (Query)

字段 类型 必填 说明
collection_id int 博客专辑 ID

请求示例

cURL

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

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "collection_data": {
            "title": "blog article title",
            "body_html": "blog article description",
            "meta_title": "blog article title",
            "meta_keywords": "blog article",
            "meta_description": "blog article description"
        },
        "collection_tranlate": [
            {
                "id": 70,
                "shop_id": 15,
                "collection_id": 126,
                "lang_code": "cn",
                "title": "博客文章标题",
                "body_html": "博客文章描述",
                "meta_title": "博客文章标题",
                "meta_keywords": "博客文章",
                "meta_description": "博客文章描述",
                "created_at": "2026-06-07 18:05:43",
                "updated_at": "2026-06-07 18:05:43"
            }
        ]
    },
    "message": "success"
}

返回字段说明

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

data 字段

字段 类型 说明
collection_data Object 专辑的默认/基础语言数据
collection_tranlate Array[Object] 专辑各语言的翻译数据

collection_data 字段(翻译字段)

字段 类型 说明
title string 专辑标题
body_html string 专辑描述(HTML 格式)
meta_title string SEO 标题
meta_keywords string SEO 关键词
meta_description string SEO 描述

collection_tranlate 子项字段

字段 类型 说明
id int 翻译记录 ID
shop_id int 店铺 ID
collection_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. collection_tranlate 中可能不含某些语言的翻译(语言刚添加或未编辑),UI 应对缺失语言提供空输入框
  2. 修改翻译时,通过 lang_code 与保存接口对应,不需要传 id
  3. 编辑完整流程:翻译语言列表 → 本接口获取翻译数据 → 回填 UI → 保存翻译
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-07 18:32:30

results matching ""

    No results matching ""