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

多语言 - 保存商品 Item 翻译

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

接口信息

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

    编辑逻辑:

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

认证

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

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

请求参数 (JSON Body)

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

product_option_items_translate 结构

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

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

请求示例

请求体 JSON

{
    "product_option_items_translate": {
        "cn": {
            "lang_code": "cn",
            "translate": {
                "Blue": "蓝色",
                "Black": "黑色",
                "Pink": "粉色",
                "M": "M",
                "L": "L",
                "XL": "XL"
            }
        },
        "ja": {
            "lang_code": "ja",
            "translate": {
                "Blue": "ブルー",
                "Black": "ブラック",
                "Pink": "ピンク",
                "M": "M",
                "L": "L",
                "XL": "XL"
            }
        }
    }
}

cURL

curl --location --request POST '{your-site-url}/api/skill/addons-language/save-option-item-translate' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{"product_option_items_translate":{"cn":{"lang_code":"cn","translate":{"Blue":"蓝色","Black":"黑色","M":"M"}},"ja":{"lang_code":"ja","translate":{"Blue":"ブルー","Black":"ブラック","M":"M"}}}}'

返回结果

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

成功响应

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

返回字段说明

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

注意事项

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

results matching ""

    No results matching ""