插件:多语言-保存商品变体Option翻译

多语言 - 保存商品 Option 翻译

保存商品变体 Option(规格,如 Color、Size)的多语言翻译。与 插件:多语言-保存商品翻译(主体) 返回的 product_options_translate 结构一致,获取后修改直接提交即可。

接口信息

  • 接口地址: {your-site-url}/api/skill/addons-language/save-option-translate
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: POST
  • 说明: 保存商品变体 Option 的多语言翻译。

    编辑逻辑:

    1. 插件:多语言-保存商品翻译(主体) 拿到 product_options_data(如 ["Color", "Size"])和 product_options_translate
    2. 结合店铺已配置的语言列表,比对每个语言下 translate 对象:
      • 如果某个 Option(如 Color)在 translate 中不存在或值为空 → 补充翻译
    3. 将补齐后的翻译数据通过本接口保存

认证

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

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)
Content-Type application/json

请求参数 (JSON Body)

字段 类型 必填 说明
variant_option_langs Object Option 翻译数据。结构与获取接口的 product_options_translate 一致

variant_option_langs 结构

外层 key 为语言简码(如 cnja),value 为对象,包含:

字段 类型 说明
lang_code string 语言简码
translate Object 翻译键值对。key = Option 原始值(如 ColorSize),value = 翻译文本

请求示例

请求体 JSON

{
    "variant_option_langs": {
        "cn": {
            "lang_code": "cn",
            "translate": {
                "Size": "尺码",
                "Color": "颜色"
            }
        },
        "ja": {
            "lang_code": "ja",
            "translate": {
                "Size": "サイズ",
                "Color": "カラー"
            }
        }
    }
}

cURL

curl --location --request POST '{your-site-url}/api/skill/addons-language/save-option-translate' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{"variant_option_langs":{"cn":{"lang_code":"cn","translate":{"Size":"尺码","Color":"颜色"}},"ja":{"lang_code":"ja","translate":{"Size":"サイズ","Color":"カラー"}}}}'

返回结果

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

成功响应

{
    "code": 200,
    "data": [],
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Array 成功时为空数组 []

注意事项

  1. 数据来源:从 插件:多语言-保存商品翻译(主体)product_options_data + product_options_translate 比对后得出
  2. 结构与获取接口的 product_options_translate 完全一致,无需转换
  3. 支持部分更新:只传入需要修改的语言即可
  4. translate 对象中,value 为空字符串表示该 Option 尚未翻译
  5. 商品翻译四个 API 组合使用:获取 → 主体保存 / Option 保存 / Item 保存
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-08 20:01:50

results matching ""

    No results matching ""