(以“{{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-正常，其他为异常 |
其他
无
相关问题
无
