插件：多语言-翻译语言列表

获取店铺已配置的翻译语言列表。用于多语言数据编辑场景（如商品、专辑、博客、自定义页面、模板装修等），获取后在 UI 中渲染多语言输入框，让用户填写各语言的内容。

接口信息

• 接口地址: {your-site-url}/api/skill/addons-language/get-translate-langs
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET

• 说明: 获取店铺当前已配置的翻译语言列表。该列表用于多语言数据编辑时的 UI 展示——根据返回的语言列表渲染多语言输入框，用户为每种语言填写对应的翻译内容。

  语言列表的内容受 插件：多语言-获取配置 中 default_use_translate 值影响：

  • default_use_translate = 1（开启默认语言翻译）：返回的语言列表包含店铺基础语言（因为店铺默认语言切换后基础语言的数据也需要翻译填充）
  • default_use_translate = 2（关闭默认语言翻译）：返回的语言列表不包含店铺基础语言（基础语言的数据不需要翻译）

认证

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

请求参数

无参数。

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/addons-language/get-translate-langs' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "languages": [
            {
                "code": "cn",
                "full_code": "zh-CN",
                "origin_name": "简体中文",
                "chinese_name": "简体中文",
                "english_name": "Simplified Chinese"
            },
            {
                "code": "ja",
                "full_code": "ja-JP",
                "origin_name": "日本語",
                "chinese_name": "日语",
                "english_name": "Japanese"
            }
        ],
        "shop_lang_code": "en"
    },
    "message": "success"
}

返回字段说明

data 字段

languages 子项字段

使用场景

在做以下内容的多语言数据编辑时，需调用本接口获取语言列表，渲染多语言输入框：

1. 商品的多语言名称、描述
2. 商品专辑的多语言名称、描述
3. 博客文章/专辑的多语言内容
4. 自定义页面的多语言内容
5. 模板装修中的多语言文案

注意事项

1. languages 是否包含店铺基础语言，取决于 插件：多语言-获取配置 中 default_use_translate 的值：1 包含，2 不包含
2. code 字段用于 lang_params 中的 key，格式如 {"en": "Hello", "cn": "你好"}
3. 修改店铺语言后，翻译语言列表会自动同步变更