Product Save Translate Data API 文档

接口信息

接口地址: {your-site-url}/api/skill/product/save-product-translate-data
基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
请求方式: POST
Content-Type: application/json
说明: 此接口用于保存商品的多语言翻译数据。通常与商品-获取需要翻译的商品数据组合使用：先获取需要翻译的数据，翻译后再通过本 API 保存回商品。

认证

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

Header	值
`skill-access-token`	`{your-skill-access-token}` （请替换为你自己的 token）

请求参数 (Body - JSON)

字段	类型	必填	说明
`product_id`	int	✅ 必填	商品 ID
`common_attrs`	Object	选填	商品基本属性的多语言翻译数据，按语言代码分组
`options`	Object	选填	商品规格名称的多语言翻译数据，按语言代码分组
`option_items`	Object	选填	商品规格子项的多语言翻译数据，按语言代码分组

common_attrs 子字段

按语言代码分组，每个语言下包含以下字段：

字段	类型	说明
`feed_title`	string	Feed 自定义 title
`feed_description`	string	Feed 自定义 description
`title`	string	商品标题
`sub_title`	string	商品副标题
`body_html`	string	商品描述（HTML）
`meta_title`	string	SEO 标题
`meta_keywords`	string	SEO 关键字
`meta_description`	string	SEO 描述

options 子字段

按语言代码分组，每个语言下 key 为规格名称（如 "Color"、"Size"），value 为翻译后的文字。

option_items 子字段

按语言代码分组，每个语言下 key 为规格子项名称（如 "grey"、"white"、"L"），value 为翻译后的文字。

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/product/save-product-translate-data' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_id": 4932,
    "common_attrs": {
        "cn": {
            "feed_title": "卡通熊印花女士开衫睡衣套装",
            "feed_description": "可爱卡通熊印花女士家居服套装...",
            "title": "卡通熊印花女士开衫睡衣短袖短裤家居服套装",
            "sub_title": "可爱小熊印花家居服套装...",
            "body_html": "<p>穿上这款可爱的卡通熊印花女士睡衣套装...</p>",
            "meta_title": "女士卡通熊开衫睡衣套装 短袖短裤家居服",
            "meta_keywords": "女士睡衣, 小熊印花睡衣...",
            "meta_description": "选购这款可爱卡通熊印花女士睡衣套装..."
        },
        "ja": {
            "feed_title": "クマ柄プリント レディース カーディガン パジャマ セット",
            "feed_description": "かわいいクマ柄のレディースパジャマセット...",
            "title": "クマ柄プリント レディース カーディガンパジャマ 半袖 ショーツ ルームウェア セット",
            "sub_title": "かわいいクマ柄のルームウェアセット...",
            "body_html": "<p>かわいいクマ柄がプリントされたこのレディースパジャマセット...</p>",
            "meta_title": "レディース クマ柄 カーディガン パジャマ セット...",
            "meta_keywords": "レディースパジャマ, クマ柄パジャマ...",
            "meta_description": "かわいいクマ柄のレディースパジャマセット..."
        }
    },
    "options": {
        "cn": {
            "Color": "颜色",
            "Size": "尺码"
        },
        "ja": {
            "Color": "カラー",
            "Size": "サイズ"
        }
    },
    "option_items": {
        "cn": {
            "grey": "灰色",
            "white": "白色",
            "L": "L",
            "M": "M"
        },
        "ja": {
            "grey": "グレー",
            "white": "ホワイト",
            "L": "L",
            "M": "M"
        }
    }
}'

返回结果

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

成功响应

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

返回字段说明

字段	类型	说明
`code`	Number	状态码，`200` 表示成功
`message`	String	执行结果的文字描述
`data`	Array	返回数据（成功时为空数组）

注意事项

系统必须启用多语言插件（language），否则此 API 无法使用
本 API 需与获取翻译数据 API:商品-获取需要翻译的商品数据组合使用：先获取，翻译，再保存
common_attrs、options、option_items 均为选填，但至少需要传入其中一个
数据按语言代码分组，key 为语言代码（如 "cn"、"ja"），value 为该语言下的翻译数据
支持的语言代码参考获取翻译数据 API 文档中的语言表

商品-保存翻译后的商品数据