(以“{{api_desc_v2_ecs| uri=goods/setGoodsPricePin| desc=使用PIN码作为标识来修改商品价格| httpMethod=POST| needAuth=是| level={{Api_L2}}| rateLimit=是| pa...”为内容创建页面) |
|||
第8行: | 第8行: | ||
params= | params= | ||
{{api_args|goods_id|true|int|商品ID}} | {{api_args|goods_id|true|int|商品ID}} | ||
− | {{api_args|skus|true|string| | + | {{api_args|skus|true|string|需要修改的SKU数据数组,以JSON字符串形式传参,数组中的各元素均必填,元素列表说明如下<br/> |
− | pin:需要修改的SKU对应的第三方PIN码 | + | pin:需要修改的SKU对应的第三方PIN码<br/> |
− | retail_price:需要设置的库存数据,单位为元(仅支持小数点后两位) | + | retail_price:需要设置的库存数据,单位为元(仅支持小数点后两位)<br/> |
示例:<nowiki>[{"pin":"GB1234","retail_price":111},{"pin":"GB2345","retail_price":112}]</nowiki>}}| | 示例:<nowiki>[{"pin":"GB1234","retail_price":111},{"pin":"GB2345","retail_price":112}]</nowiki>}}| | ||
relat_qa=无| | relat_qa=无| |
2022年12月27日 (二) 14:19的版本
goods/setGoodsPricePin
使用PIN码作为标识来修改商品价格
URL
https://api.weibo.com/2/proxy/eshop/open/goods/setGoodsPricePin
返回格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于电商服务商应用授权,参见 电商服务商应用 基础能力
访问授权限制
访问级别:高级接口(需要授权) - 仅限电商服务商第三方开发者
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得,此参数放在GET请求中 |
appid | true | int | 电商服务商的身份标识,需联系微博电商分配获得 |
sign | true | string | 验证签名,签名算法见 电商服务商接口验证签名 |
goods_id | true | int | 商品ID |
skus | true | string | 需要修改的SKU数据数组,以JSON字符串形式传参,数组中的各元素均必填,元素列表说明如下 pin:需要修改的SKU对应的第三方PIN码 |
注意事项
- 1、该接口仅支持传第三方PIN码参数修改对应价格数据,如果要使用 sku_id 作为标识更改商品价格,请参见 使用SKU ID作为标识来修改商品价格 接口
- 2、该接口仅支持已经通过运营审核的正式商品修改商品价格数据,如果要修改商品草稿的价格数据,请参见 编辑商品草稿 接口
- 3、该接口仅支持修改价格数据,如果要修改商品其他信息,请参见 修改商品 接口
- 4、为了保证数据安全性,接口会校验所修改商品的PIN码的唯一性,对于历史商品如果PIN码不唯一的话将无法通过此接口修改商品价格数据
返回结果
JSON示例
{ "code": 0, "msg": "", "data": { }, "consume": 60, "time": 1658143987 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
code | int | 返回状态码,0-正常,其他为异常 |
其他
无
相关问题
无