自助匹配物理房型信息查询接口
收藏
我的收藏接口说明
门店下物理房型查询
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/trip/physical_room/search/ |
HTTP Method | POST |
Scope | life.capacity.trip_physical_room_pull |
权限要求 | 酒店行业日历房解决方案-物理房型静态信息自助获取能力 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
account_id必填String
抖音侧商家Id
poi_idsList
抖音侧酒店id列表(poi_id等价于上文中的hote_id,一次性不宜查询过多,单次请求最多支持10个门店)
展开子属性
请求示例
curl --location --request POST 'https:// open.douyin.com/goodlife/v1/trip/physical_room/search/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"base":{"addr":"zuNneSr0wQ","client":"JDILS1rm79","traffic_env":{"open":false,"env":"9qI1ILOO6c"},"extra":{"WHw6EqW4Rz":"C6bzRzgdEL"},"log_i_d":"XSltDrgx5M","caller":"qlp2Ennz93"},"account_id":"8aYHRWCGim","poi_ids":["qj12YL5oKr"]}'
响应参数
Body展开全部子属性
dataStruct
数据对象
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20241205000736EF6750DF623778775B45", "now": 1733328456 }, "base_resp": { "status_message": "uRBCNFkYqR", "status_code": 3309807850979182000, "extra": { "7jy48ckeyj": "Iw0zl5hRmq" } }, "data": { "room_lists": { "gevhU5ny44": [ { "area": { "value_list": [ 6059235310053573000 ], "value_type": 1 }, "room_num": 8989902518468983000, "max_occupancy": 4748868328593679000, "floor": [ { "value_type": 1, "value_list": [ 6670085056130391000 ] } ], "descriptions": [ "Qk9P9RGANb" ], "images": [ { "image_url": "cuA9oxiaI5", "image_uri": "HyHJbYrqaU" } ], "facility_map": { "NGgRlD7BS3": { "facility_ids": [ 1294781389400383500 ] } }, "cn_name": "s1skKNm6Kc", "internets": [ 1 ], "bed_groups": [ { "bed_items": [ { "bed_type": 1, "bed_size": 8204589074236926000, "bed_num": 2381609793002478600 } ] } ], "room_id": "qSHK7W9fmT", "window": 1, "category_id": 4962754851697232000, "status": 1, "smoking": 1, "en_name": "zemOVY49t5" } ] }, "error_code": 0, "description": "" } }
切换单列布局
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
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 | 5000001 | 服务器打瞌睡了,请稍后再试。 | |
200 | 3000001 | 以实际错误信息为准 |
点击纠错