Product Update (Multi-Language) API 文档

商品-更新-全量更新-支持多语言数据

接口信息

• 接口地址: {your-site-url}/api/skill/product/update-language-product
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• Content-Type: application/json
• 说明: 此接口用于更新多语言商品

认证

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

与普通更新接口的区别

此接口与 /api/skill/product/update 参数结构类似，核心区别在于以下字段使用多语言数据格式：

多语言数据格式

{
    "default": "默认语言文本（英文）",
    "languages": {
        "cn": "简体中文",
        "tw": "繁體中文",
        "it": "Italian text",
        "de": "German text",
        "ja": "日本語"
    }
}

• default：默认语言文本（必填）
• languages：其他语言翻译对象，key 为语言代码，value 为翻译文本

请求参数 (Body - JSON)

顶层字段

product 字段详表

productattr_info 字段详表

images 字段详表

videos 字段详表

options 字段详表

单规格产品为空，多规格产品必填。

variants 字段详表

单规格产品数组只有一个子项。

tags 字段详表

glasses 字段详表

mergeimages 字段详表

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/product/update-language-product' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product": {
        "id": 4932,
        "spu": "3232323",
        "title": {
            "default": "Cartoon Bear Printing Women'\''s Cardigan Pajamas...",
            "languages": {
                "it": "Pigiama da Donna con Stampa Orsetto Cartoon...",
                "tw": "卡通小熊印花女士開襟睡衣...",
                "de": "Damen Pyjama Set mit Cartoon-Bärenprint...",
                "ja": "漫画風ベアプリント...",
                "cn": "卡通小熊印花女士开襟睡衣套装..."
            }
        },
        "sub_title": {
            "default": "Cute bear print loungewear set...",
            "languages": {
                "it": "Set loungewear con graziosa stampa di orsetti...",
                "tw": "可愛小熊印花居家服套裝...",
                "de": "Niedliches Loungewear-Set...",
                "ja": "通気性の良い半袖カーディガン...",
                "cn": "可爱小熊印花居家服套装..."
            }
        },
        "body_html": {
            "default": "<p>Stay comfortable and stylish...</p>",
            "languages": {
                "it": "<p>Rimani comoda e alla moda...</p>",
                "tw": "<p>這款女士睡衣套裝...</p>",
                "de": "<p>Genießen Sie Komfort...</p>",
                "ja": "<p>可愛い漫画風ベアプリント...</p>",
                "cn": "<p>这款女士睡衣套装...</p>"
            }
        },
        "status": 1,
        "is_tax": 1,
        "virtual_sales_count": 33,
        "type": 2,
        "vendor": "Lighting Made",
        "variant_need_note": "1",
        "variant_need_image": 1,
        "variant_show_image": 3,
        "inventory_police": 1,
        "inventory_police_type": 1,
        "meta_is_edit": 2,
        "meta_title": {
            "default": "Women'\''s Cartoon Bear Cardigan Pajama Set...",
            "languages": {
                "it": "Pigiama Donna Orsetto Cartoon...",
                "tw": "女士卡通小熊開襟睡衣套裝...",
                "de": "Damen Cartoon-Bären Pyjama Set...",
                "ja": "レディース ベアプリント...",
                "cn": "女士卡通小熊开襟睡衣套装..."
            }
        },
        "meta_keywords": {
            "default": "women pajamas, bear print pajama...",
            "languages": {
                "it": "pigiama donna, stampa orsetto...",
                "tw": "女士睡衣, 小熊印花睡衣...",
                "de": "Damen Pyjama, Bärenprint...",
                "ja": "レディースパジャマ, ベアプリント...",
                "cn": "女士睡衣, 小熊印花睡衣..."
            }
        },
        "meta_description": {
            "default": "Shop this cute women'\''s cartoon bear pajama set...",
            "languages": {
                "it": "Acquista questo grazioso pigiama...",
                "tw": "選購這款可愛女士卡通小熊睡衣套裝...",
                "de": "Entdecken Sie dieses niedliche Damen-Pyjama-Set...",
                "ja": "通気性の良い半袖カーディガン...",
                "cn": "选购这款可爱女士卡通小熊睡衣套装..."
            }
        },
        "feed_description": "google feed description",
        "feed_title": "google feed title",
        "handle": "cartoon-bear-printing-women-cardigan-pajamas-short-sleeve-shorts-fayej0xz",
        "translate_type": 3,
        "google_product_category": 111,
        "google_product_type_id": "light",
        "description_json": [],
        "description_json_status": 2,
        "params_json": [],
        "params_json_status": 2,
        "short_description_json": [],
        "label_ids": [],
        "collection_ids": [],
        "template_type": "product"
    },
    "productattr_info": [],
    "images": [
        {
            "id": 31548,
            "product_id": 4932,
            "position": 1,
            "src": "/product/15/image/2026/04/28/3fb5620f4acf97bdf9d056a6220b87e0.jpg",
            "alt": "",
            "width": 600,
            "height": 600,
            "ratio": "1.00"
        },
        {
            "id": 31549,
            "product_id": 4932,
            "position": 2,
            "src": "/product/15/image/2026/04/28/f6d04b41c743455948ed5dfea357a53e.jpg",
            "alt": "",
            "width": 600,
            "height": 600,
            "ratio": "1.00"
        },
        {
            "id": 31550,
            "product_id": 4932,
            "position": 3,
            "src": "/product/15/image/2026/04/28/858278fe4f6d493ece46810169a4df21.jpg",
            "alt": "",
            "width": 600,
            "height": 600,
            "ratio": "1.00"
        }
    ],
    "videos": [
        {
            "id": 873,
            "product_id": 4932,
            "position": 1,
            "src": "https://cloud.video.taobao.com/play/u/2206786293671/p/1/e/6/t/1/453995116363.mp4",
            "alt": ""
        }
    ],
    "addition_group_id": 73,
    "variantremark_id": 9,
    "groupbuy_id": 12,
    "collection_ids": [342, 343],
    "label_ids": [],
    "options": [
        {
            "id": 5291,
            "shop_id": 15,
            "product_id": 4932,
            "name": {
                "default": "Color",
                "languages": {
                    "it": "Colore",
                    "tw": "顏色",
                    "de": "Farbe",
                    "cn": "颜色",
                    "ja": "カラー"
                }
            },
            "position": 1,
            "items": [
                {
                    "default": "grey",
                    "languages": {
                        "it": "grigio",
                        "tw": "灰色",
                        "cn": "灰色",
                        "de": "grau",
                        "ja": "グレー"
                    }
                },
                {
                    "default": "white",
                    "languages": {
                        "it": "bianco",
                        "tw": "白色",
                        "cn": "白色",
                        "de": "weiß",
                        "ja": "ホワイト"
                    }
                }
            ]
        },
        {
            "id": 5292,
            "shop_id": 15,
            "product_id": 4932,
            "name": {
                "default": "Size",
                "languages": {
                    "it": "Taglia",
                    "tw": "尺寸",
                    "cn": "尺寸",
                    "de": "Größe",
                    "ja": "サイズ"
                }
            },
            "position": 2,
            "items": [
                {
                    "default": "L",
                    "languages": {
                        "it": "L-it",
                        "tw": "L-tw",
                        "de": "L-de",
                        "cn": "L-cn",
                        "ja": "L-ja"
                    }
                },
                {
                    "default": "M",
                    "languages": {
                        "it": "M-it",
                        "tw": "M-tw",
                        "de": "M-de",
                        "cn": "M-cn",
                        "ja": "M-ja"
                    }
                }
            ]
        }
    ],
    "variants": [
        {
            "id": 45140,
            "shop_id": 15,
            "product_id": 4932,
            "title": "grey / L",
            "price": "59.99",
            "compare_at_price": "69.99",
            "cost_price": "29.99",
            "wholesale_price": [
                {"qty": 2, "price": "45.88"},
                {"qty": 5, "price": "41.88"}
            ],
            "sku": "3232323-grey-L-1010805",
            "barcode": "1111",
            "image_id": 31548,
            "qty": 8999,
            "option1": {
                "default": "grey",
                "languages": {
                    "it": "grigio",
                    "tw": "灰色",
                    "cn": "灰色",
                    "de": "grau",
                    "ja": "グレー"
                }
            },
            "option2": {
                "default": "L",
                "languages": {
                    "it": "L-it",
                    "tw": "L-tw",
                    "de": "L-de",
                    "cn": "L-cn",
                    "ja": "L-ja"
                }
            },
            "option3": "",
            "weight": "11.00",
            "weight_unit": "kg",
            "note": "grey l",
            "image": "/product/15/image/2026/04/28/3fb5620f4acf97bdf9d056a6220b87e0.jpg",
            "customervip": [
                {"customervip_id": 11, "price": 44},
                {"customervip_id": 10, "price": 45},
                {"customervip_id": 8, "price": 46},
                {"customervip_id": 7, "price": 47}
            ],
            "images": [],
            "buy_min_count": 1
        },
        {
            "id": 45141,
            "shop_id": 15,
            "product_id": 4932,
            "title": "grey / M",
            "price": "59.99",
            "compare_at_price": "69.99",
            "cost_price": "29.99",
            "wholesale_price": [
                {"qty": 2, "price": "45.88"},
                {"qty": 5, "price": "41.88"}
            ],
            "sku": "3232323-grey-M-1010806",
            "barcode": "2222",
            "image_id": 31548,
            "qty": 8999,
            "option1": {
                "default": "grey",
                "languages": {
                    "it": "grigio",
                    "tw": "灰色",
                    "cn": "灰色",
                    "de": "grau",
                    "ja": "グレー"
                }
            },
            "option2": {
                "default": "M",
                "languages": {
                    "it": "M-it",
                    "tw": "M-tw",
                    "de": "M-de",
                    "cn": "M-cn",
                    "ja": "M-ja"
                }
            },
            "option3": "",
            "weight": "11.00",
            "weight_unit": "kg",
            "note": "grey m",
            "image": "/product/15/image/2026/04/28/3fb5620f4acf97bdf9d056a6220b87e0.jpg",
            "customervip": [
                {"customervip_id": 11, "price": 44},
                {"customervip_id": 10, "price": 45},
                {"customervip_id": 8, "price": 46},
                {"customervip_id": 7, "price": 47}
            ],
            "images": [],
            "buy_min_count": 1
        }
    ],
    "glasses": {
        "button_type": 1,
        "distance_min": "11.00",
        "distance_max": "99.00",
        "sex": {"value": "sex", "language": {"cn": "性别"}},
        "lens_type": {"value": "style", "language": {"cn": "类型"}},
        "material": {"value": "type", "language": {"cn": "材料"}}
    },
    "mergeimages": [],
    "tags": [
        {"id": 25, "title": "white"},
        {"id": 79, "title": "black"}
    ],
    "payafteruse": 2
}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "product_id": 4932
    },
    "message": "success"
}

返回字段说明

错误码说明

注意事项

1. product.id 在更新时必须传入，否则可能被当作新增处理
2. 多语言字段格式为 {"default": "默认文本", "languages": {"语言代码": "翻译文本"}}
3. default 为必填，languages 为可选（可传空对象 {}）
4. options[].name 和 options[].items 中的每个子项均为多语言格式
5. variants[].option1/2/3 的 default 值必须与对应 position 的 options[].items 中某个子项的 default 值匹配
6. 如果 option1/2/3 不涉及多语言翻译，可直接传空字符串 ""
7. 变体的 image 字段必须已存在于 images 数组中，否则无法保存
8. images[].position 必须从 1 开始连续递增，position=1 的图片为主图
9. options[].position 只能为 1、2、3，且每个 option 的 position 不可重复
10. wholesale_price 为变体的批发价格数组，每个元素包含 qty（起批数量）和 price（批发单价）
11. weight_unit 支持 g、kg、lb、oz 四种单位
12. 更新已有数据时传入 id（图片 ID、变体 ID、Option ID 等），新增数据时不传 id