同步库存
收藏同步库存
使用限制
无
接口说明
无
基本信息
HTTP URL | ||||
HTTP Method | POST | |||
申请权限 | 商品发布 | |||
权限要求 |
| |||
请求头
参数 | 描述 | 必须 |
Content-Type | application/json | 是 |
access-token | 是 |
请求参数
Body 请求
参数名称 | 参数类型 | 是否必传 | 参数描述 |
product_id | string | TRUE | 商品id(若有第三方id可不传） |
out_id | string | TRUE | 商品第三方id |
stock | StockStruct | TRUE | 库存信息 |
- limit_type | int | TRUE | 库存上限类型，为2时stock_qty和avail_qty字段无意义 1-有限库存 2-无限库存 |
- stock_qty | int | TRUE | 总库存，limit_type=2时无意义 |
account_id | string | TURE | 商家ID，传入时服务商须与该商家满足授权关系 |
请求示例
{ "out_id": "hch-life-0314-yry01", "stock": { "limit_type": 2, "avail_qty": 88 }, "account_id": "123123123" }
响应参数
参数名称 | 参数类型 | 是否必传 | 参数描述 |
data | struct | TRUE | 响应信息 |
- error_code | int | TRUE | 错误码 |
- description | string | TRUE | 错误描述 |
extra | struct | TRUE | 响应额外信息 |
- error_code | int | TRUE | 错误码 |
- description | string | TRUE | 错误描述 |
- sub_error_code | int | TRUE | （弃用）子错误码 |
- sub_description | string | TRUE | （弃用）子错误描述 |
- now | int | TRUE | （弃用）时间戳 |
- logid | string | TRUE | 请求日志ID |
data | struct | TRUE | 响应信息 |
- error_code | int | TRUE | 错误码 |
- description | string | TRUE | 错误描述 |
响应示例
正常示例
{ "data": { "error_code": 0, "description": "success" }, "extra": { "error_code": 0, "description": "success", "sub_error_code": 0, "sub_description": "", "logid": "xxx", "now": 1651113600 } }
错误码
HTTP 状态码 | 错误码 | 错误消息 | 排查建议 |
200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
200 | 2190004 | 应用申请接口权限 | |
200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制，检查是否有测试环境在同步刷新token |
200 | 2119001 | 参数不合法 | 更换参数 |
200 | 2119002 | 系统繁忙，请稍候再试 | 重试 |
200 | 2119003 | 请求太过频繁，请稍后再试 | 重试 |
200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权，并在服务商后台同意授权 |
200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 4000001 | 补充参数 | |
200 | 4000002 | 对照接口文档规范参数并重试 | |
200 | 5000001 | 联系抖音处理 |
