查询在线加料品列表
接口说明
线上附属品列表
使用限制
仅用于B端场景,可承载流量较低,如需高流量场景使用,建议通过商品审核事件、商品状态变更事件做数据异构。
SLA:支持的最大QPS:10;基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/goods/foodorder/affiliated/list/ |
| HTTP Method | POST |
| Scope | life.capacity.ordering.goods.query |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body展开全部子属性
account_id必填Int64
countInt64
页大小 0~20
cursorString
游标 默认0
product_nameString
模糊搜索商品名称
query_typeEnum
查询数据范围
0 查询开发者创建的商品
1 查询商家创建的商品
2 自建开发者查询关联商家下全部商品
3 服务商查询关联商家下全部商品
展开子属性
status_listList
筛选商品状态
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/goods/foodorder/affiliated/list/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"count":7842702881560657398,"query_type":1,"status_list":[1],"product_name":"5SaPy91i7w","account_id":2824492834625267908,"Base":{"Client":"ABEd2MCuzN","TrafficEnv":{"Open":false,"Env":"G0cVDt4CMF"},"Extra":{"jQakMH3aa1":"AOUWXFdoLw"},"LogID":"NY93uax5Q2","Caller":"ebkB3nHeNJ","Addr":"Op8A01lpi2"},"cursor":"AL72m0XXbn"}'
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
BaseRespStruct
展开子属性
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20260804143008D46A6A06939886596CEE", "now": 1785825011 }, "BaseResp": { "StatusMessage": "rNZyLDY9Jw", "StatusCode": 1609454915640831500, "Extra": { "I7vmI0MBAu": "WW8PTW2MbD" } }, "data": { "error_code": 0, "description": "", "affiliated_list": [ { "out_url": "SZTe6goeI1", "price": { "origin_amount": 6589073754382537000, "actual_amount": 4351110944494285000 }, "product_id": 477303691895137000, "stock": 2675991544409622500, "account_id": 2581688273100435500, "out_id": "QEfqkaAwvJ", "poi_list": [ { "ext_id": "UuTusoxSuc", "poi_id": 2635047661879998000 } ], "category_id": 8040239057184409000, "fulfillment_type": [ 1 ], "name": "znH7P4SkCf", "settle_info": { "settle_type": 1 }, "biz_line": 1 } ], "next_cursor": "XVRu5H0X0K", "has_more": false } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 请根据接口错误返回信息调整参数 |
| 200 | 2119001 | 参数不合法 | 请根据接口错误返回信息调整参数 |
| 200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
| 200 | 2119010 | 接口已下线 | 接口已下线 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
| 200 | 3000001 | 根据实际业务错误返 回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 5000001 | 以实际错误信息为准 | 联系oncall处理 |
