小蜜蜂-产品更新
v2.0.0基于“Bee Website Builder” Open API的产品更新技能。它用于更新指定站点语言下的现有产品,并支持更新产品信息,如组、名称、型号、图像、属性、标签和描述。
运行时依赖
安装命令
点击复制技能文档
bee-products-update 版本:2.0.0 概述 使用 Bee Website Builder Open API 更新现有产品。支持更新指定语言下的产品信息,包括组、名称、型号、图像、属性、标签、简要描述和详细描述。
输入参数 api_key (字符串,必需) API 身份验证密钥,用于识别调用者和控制接口访问权限。从 https://open.tradew.com 获取。用于 API 权限验证 language (字符串,必需) 更新到指定启用站点的启用语言。 必须从 bee-languages-get 返回的列表中手动选择。不允许使用 AI 推断或自动生成。 products (对象,必需) 要更新的产品信息。 products.products_id (整数,必需) 要更新的产品 ID。 products.productsgroup_id (整数,可选) 产品组 ID。 仅支持没有子组的 ID。请参阅产品组 API 以获取详细信息。> 0 表示更新到指定组。 products.product_name (字符串,可选) 产品名称,最大 300 个字符。空字符串或省略表示不更新。 products.model (字符串,可选) 产品型号,最大 50 个字符。空字符串或省略表示不更新。 products.upload_images (数组,可选) 图像上传列表,最大 5 张图像。第一张图像为主图像。空值或省略表示不更新。每个项包含: 字段 类型 描述 name 字符串 图像名称 base64 字符串 Base64 图像数据,例如 image/jpeg;base64,... 每个图像必须小于 500 kB。 products.attributes (数组,可选) 属性列表,最大 15 项。空值或省略表示不更新。每个项包含: 字段 类型 描述 name 字符串 属性名称,最大 100 个字符 value 字符串 属性值,最大 100 个字符 products.tags (数组,可选) 关键字标签列表,最大 6 项。 products.brief_description (字符串,可选) 简要描述,纯文本,最大 127 个字符。空字符串或省略表示不更新。 products.description (字符串,可选) 详细描述,HTML,最大 100,000 个字符。空字符串或省略表示不更新。
输出结构 顶级结构 字段 类型 描述 status 布尔值 请求状态 msg 字符串 响应消息 data 对象/空 返回数据 data 字段 类型 描述 products_id 整数 更新的产品 ID
依赖关系 参数 依赖 技能 字段 源 模式 language bee-languages-get list[].language 选择 products.productsgroup_id bee-productsgroup-read list[].productsgroup_id 选择(过滤:is_leaf=true)
使用示例 { "api_key": "your-api-key", "language": "en", "products": { "products_id": 456, "productsgroup_id": 3445, "product_name": "product name", "model": "A1386", "upload_images": [ { "name": "image1", "base64": "image/jpeg;base64,..." } ], "attributes": [ { "name": "color", "value": "red" } ], "tags": ["tags 1", "tags 2"], "brief_description": "brief description", "description": "detailed description" } }
响应示例 { "status": true, "msg": "update successfully", "data": { "products_id": 8 } }