餐饮团购-同步商品库存
收藏
我的收藏同步库存
使用限制
无
接口说明
1、小程序商品使用,非小程序商品可忽略此接口
基本信息
HTTP URL | ||||
HTTP Method | POST | |||
申请权限 | 商品发布 | |||
权限要求 |
|
请求头
参数 | 描述 | 必须 |
Content-Type | application/json | 是 |
access-token | 是 |
请求参数
Body 请求
参数名称 | 参数类型 | 是否必传 | 参数描述 |
| string | FALSE | 商品id product_id 和out_id 字段须二选一 |
| string | FALSE | 商品第三方id product_id 和out_id 字段须二选一 |
| StockStruct | TRUE | 库存信息 |
| int | TRUE | 库存上限类型,为2时stock_qty字段无意义 1-有限库存 2-无限库存 |
| int | TRUE | 总库存,limit_type=2时无意义 |
| string | TURE | 商家ID,传入时服务商须与该商家满足授权关系 |
请求示例
curl --location 'https://open.douyin.com/goodlife/v1/akte/goods/stock/sync/' \ --header 'access-token: clt.fbf20fbdd88a69ef7e52bf7c953b2d94aJghqCfoYQJsiuCM43y9f8dK9Pmh' \ --header 'Content-Type: application/json' \ --header 'Cookie: passport_csrf_token=07a8ffb6d249f30aaacb663c962296d4; passport_csrf_token_default=07a8ffb6d249f30aaacb663c962296d4' \ --data '{ "out_id": "akte_goods_demo", "stock": { "limit_type": 1, "stock_qty": 800 }, "account_id": "7166966001467131917" }'
响应参数
参数名称 | 参数类型 | 是否必传 | 参数描述 |
| struct | TRUE | 响应信息 |
| int | TRUE | 错误码 |
| string | TRUE | 错误描述 |
| struct | TRUE | 响应额外信息 |
| int | TRUE | 错误码 |
| string | TRUE | 错误描述 |
| int | TRUE | (弃用)子错误码 |
| string | TRUE | (弃用)子错误描述 |
| int | TRUE | (弃用)时间戳 |
| string | TRUE | 请求日志ID |
| struct | TRUE | 响应信息 |
| int | TRUE | 错误码 |
| 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 | 联系抖音处理 |