Product Update Columns (Multi-Language) API 文档

商品-字段更新-支持多语言

接口信息

• 接口地址: {your-site-url}/api/skill/product/update-language-columns
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• Content-Type: application/json
• 说明: 此接口用于局部更新多语言商品的指定字段。只更新传入的字段，未传或传空值的字段保持不变。

认证

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

与普通局部更新接口的区别

此接口与 /api/skill/product/update-columns 参数结构类似，区别在于以下字段支持多语言数据格式：

多语言数据格式

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

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

请求参数 (Body - JSON)

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/product/update-language-columns' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 4932,
    "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...",
            "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>"
        }
    },
    "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": "选购这款可爱女士卡通小熊睡衣套装..."
        }
    },
    "spu": "testxxxx",
    "status": 1,
    "virtual_sales_count": 212,
    "vendor": "test update columns: ddd"
}'

只更新单个多语言字段示例

curl --location --request POST '{your-site-url}/api/skill/product/update-language-columns' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 4932,
    "title": {
        "default": "New Product Title",
        "languages": {
            "cn": "新产品标题"
        }
    }
}'

混合更新（多语言字段 + 普通字段）示例

curl --location --request POST '{your-site-url}/api/skill/product/update-language-columns' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 4932,
    "status": 2,
    "vendor": "New Vendor Name"
}'

返回结果

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

成功响应

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

返回字段说明

错误码说明

注意事项

1. id 为必填，用于指定要更新的商品
2. 只更新传入的字段，未传入的字段保持原值不变
3. 传空值（空字符串 "" 或 null）视为不更新该字段
4. 多语言字段格式为 {"default": "默认文本", "languages": {"语言代码": "翻译文本"}}
5. default 为必填，languages 为可选（可传空对象 {}）
6. 多语言字段和普通字段可以在一次请求中同时更新
7. 相比 /api/skill/product/update-language-product，此接口更适合只需修改个别字段的场景