酒店静态信息接口
接口说明
- 将外部酒店静态信息与抖音侧酒店信息进行匹配,返回匹配状态
- 匹配成功后可使用抖音酒店ID更新酒店静态信息
- 酒店匹配时,经纬度字段latitude、longitude建议必传,否则影响匹配准确对
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/trip/hotel/info/match/ |
| HTTP Method | POST |
| Scope | life.capacity.trip_hotel_push |
| 权限要求 | 酒店静态信息匹配/创建/更新能力 详情参考:酒店新预售券SAAS对接方案 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Body展开全部子属性
account_id必填String
商户account_id
out_hotel_id必填String
合作方酒店ID
activeBool
合作方酒店状态
hotel_base_infoStruct
酒店基本信息
展开子属性
hotel_facilitiesList
酒店设施
展开子属性
hotel_idString
抖音酒店ID
可在抖音来客门店管理下查看(酒店匹配时不传此参数)
hotel_imagesList
酒店图片
展开子属性
hotel_policyStruct
酒店政策
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/trip/hotel/info/match/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"hotel_policy":{"breakfast_policy":{"breakfast_category":[1],"open_time":{"open_time_type":1,"every_day_time":{"start_time":{"mintue":3336068341496605635,"second":4951684051931766270,"time_limited":false,"hour":4192157823448901902},"end_time":{"hour":4617109374270853009,"mintue":2009501045179341134,"second":7745553381971763702,"time_limited":false}},"week_day_times":{"time_periods":[{"start_time":{"hour":4864486866019715840,"mintue":2712069391019464310,"second":6664419278373668871,"time_limited":false},"end_time":{"time_limited":false,"hour":7457202792042962525,"mintue":7727928068191700297,"second":2241691055995523488}}],"week_days":[1]}},"support_breakfast":false,"breakfast_form":[1],"breakfast_type":[1]},"children_policy":{"max_children_age":705715246006645554,"is_allow_sharing_bed":false,"is_allow_children":false,"min_children_age":1797566755346072357},"child_use_exist_bed_policy":{"allow_child_num":8290456114190849003,"charges":[{"charge_price":2525197649870173636,"currency":"J3HI6avr6D","charge_percent":2453691151022728722,"charge_frequency":"h4Oqme7k6k","chargeable":false,"start":3645339089665795994,"end":650296985030400135}]},"extra_bed_policy":{"extra_child_bed_charges":[{"charge_frequency":"GVsImk5BVO","chargeable":false,"start":1933664534645150470,"end":1074832306372638588,"charge_price":2320378832369426021,"currency":"OcoKXXqRmH","charge_percent":5542335262293889546}],"extra_baby_bed_charges":[{"chargeable":false,"start":4893191593387084204,"end":7476468255776592029,"charge_price":4251936480318998876,"currency":"UswEBSnhjK","charge_percent":7859522538920763472,"charge_frequency":"0nF5CJX66J"}],"support_extra_bed":false,"adult_extra_bed_price":3429737969204074163,"currency":"C0XDGwdkln"},"pet_policy":{"is_allow_pet":false},"child_breakfast_policy":{"child_breakfast_height":[{"chargeable":false,"start":5827090118242103882,"end":1726836136330691356,"charge_price":858282744896434412,"currency":"ir4ltgnuV0","charge_percent":3233459013672086642,"charge_frequency":"bDQet0Rykf"}],"age_or_height":1,"child_breakfast_age":[{"start":9167242068401471288,"end":1026713965216730647,"charge_price":5262944136533851370,"currency":"oQrkbpD4QW","charge_percent":5829425036685693557,"charge_frequency":"jyeScLruYq","chargeable":false}]},"parking_policy":{"parking_details":{"location":1,"type":1,"chargeable":false,"amount":0.34771070814433175,"currency":"bn13NztvHS","reserve_required":false},"charge_point_detail":{"location":1,"type":1},"parking_provided":false,"charging_point_provided":false},"check_in_policy":{"check_in_to":"wFPxJZ3imO","check_out_from":"gL5cdFMLUO","check_out_to":"qdWqlq64iJ","is_limit_arrival":false,"check_in_from":"esam0BFkfE"}},"base":{"client":"mqv2eVbGvi","traffic_env":{"open":false,"env":"BSBMnUnKCL"},"extra":{"fSKvee7YEq":"h2VIFQSvcA"},"log_i_d":"rfb3isEk2t","caller":"cNuurQqlQx","addr":"0l5FxoIe9r"},"account_id":"BmChc5AZJU","active":false,"hotel_base_info":{"total_room_quantity":41523961391262798,"hotel_name":"AU1fVkhx9d","hotel_en_brief":"P0tkPu7VM5","last_renovation":"JBRkEfj8fD","phone":{"phone_type":1,"country_code":"p6AwLYa8Tw","area_code":"oa88HXoh9i","main_code":"DxBU39UJyz","ext_code":"SwXmO7Eiku"},"recieve_foreign_guest":1,"hotel_en_name":"1JSYqMTrva","longitude":0.4261820987725281,"important_information":[{"effect_start_time":"pmIxBREn0g","effect_end_time":"Wkxkr1FCqn","content":"1OjysHDXef"}],"star_rating":1,"hotel_brief":"qvDyhPiu9X","currency":"gg2MHNxQGM","latitude":0.6329908238301483,"address":{"province":"367kXKwiCw","city":"6EJ0mpUps5","district":"7cxYAzi7j9","detail_address":"4QBxvXr0Ng","country":"vZaX9aToXQ"},"hotel_building_area":0.9526910152113978,"build_time":"LqgAZlJd4S"},"hotel_facilities":[{"facility_id":5761170276734501030,"facility_category":1}],"hotel_id":"GPhi7IL8Vr","hotel_images":[{"image_type":1,"image_url":"FS6C3QC1FB"}],"out_hotel_id":"qYkZQAcSmb"}'
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "hotel_id": "mCcQ1d63mH", "status": 1, "message": "GydWrfO8U0", "category_id": 1796069102954828500, "out_hotel_id": "WeVmbIeHRt", "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202603041114576BE4A8A0007E27E3B7FF", "now": 1772594100 }, "base_resp": { "status_code": 6899286169066290000, "extra": { "KNepFGRPWY": "p2rVnZqfUa" }, "status_message": "6GN5C7Qs9q" } }
错误码
| 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 | 以实际错误信息为准 |
