综合预约品订单查询
接口说明
三方调用抖音进行订单查询,非必接
industry_info_list
行业信息分了attr_key和attr_value字段。其中attr_value为jsonString存储的结构体序列化string,需要由商家自行反序列化成对象。
接口说明
暂无
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/comprehensive/trade/query/order/ |
| HTTP Method | POST |
| Scope | life.capacity.comprehensive_reserve_query_order |
| 权限要求 | 预约单查询 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body
account_id必填String
商户ID
end_time必填Int64
预约结 束时间
page_num必填Int32
page_size必填Int32
最大为50
poi_id必填String
预约地id
start_time必填Int64
预约开始时间
book_idString
抖音预定单(服务单)id
order_idString
抖音预订单id
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/comprehensive/trade/query/order/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"end_time":8592198607985141514,"start_time":3607471611684095952,"account_id":"XOM1GAP15Y","poi_id":"MH2caCzO1d","book_id":"PeSVrNbISz","order_id":"xNApIdu78m","page_num":1728371610232364123,"page_size":123338995024551354}'
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "order_list": [ { "products": [ { "sku_id": "xNThJedIhe", "sku_ame": "sYqJnWFAzk", "original_amount": "nacnInqoWu" } ], "book_time": 4339574294158384000, "booking_info": { "poi_id": "nIFO1VwRye", "item_ids": [ "ukIOEXlA6X" ], "count": 4917436453326940000, "user_notes": "7DBONBWFUN" }, "user_infos": [ { "license_type": 3690306545275389400, "license_number": "euxSUkFet0", "age": 7687908625761633000, "sex": 3855376546295431000, "marital_status": 529152616239363100, "name": "UBtc7CA4cX", "phone": "HU4WQujGMO" } ], "status": 1, "order_id": "rtCrvNpe0S", "industry_info_list": [ { "attr_value": "wqqUidlkCl", "attr_key": "HxpO9hm4L5", "attr_key_name": "MDEhF1Crkm" } ], "book_id": "UaBdqsFpI2", "book_taking_time": 3293678469073069000 } ], "total": 323409631378325200, "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2026010617062449858799C432016F2FB9", "now": 1767690385 } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001005 | 系统内部错误,请重试 | 请求重试,若依然无解请向平台提交反馈 |
| 200 | 28001003 | access_token无效 | 重新请求生成access_token |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
| 200 | 28001016 | 当前应用已被封禁或下线 | clientKey被封禁或者下线 |
| 200 | 28001006 | 网络调用错误,请重试 | 重试即可 |
| 200 | 28001014 | 应用未授权任何能力 | 确认应用是否授权能力 |
| 200 | 28001018 | 应用未获得该能力 | 开通相关能力 |
| 200 | 28003017 | quota已用完 | 联系平台处理 |
| 200 | 28001019 | 应用该能力已被封禁 | 该能力被封禁,联系平台处理 |
| 200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |
| 200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家 在商家后台发起授权,并在服务商后台同意授权 |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 3000001 | 以实际错误信息为准 | |
| 200 | 5000001 | 服务器打瞌睡了,请稍后再试。 |
