抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店日历房常见枚举值列表
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息接口
  • 酒店静态信息处理状态查询
  • 酒店静态信息处理结果推送Webhook
  • 酒店静态信息自助获取能力
  • 物理房型静态信息匹配/创建/更新
  • 营销规则价格推送
  • 物理房型上下架能力
  • 主动拉取价量态
  • 营销退出报名
  • 营销价量态拉取
  • 营销规则推送
  • 营销库存推送
  • 日历房线上开票
  • 日历房上下架能力
  • 营销规则价格模式推送
  • 营销查询
  • 入住/离店状态同步能力
  • 日历房交易正向
  • 酒店会员管理
  • 日历房交易逆向
  • 售卖房型创建/更新能力
  • 物理房型静态信息自助获取能力
  • 房价/房态/房量更新
  • 代理商-酒店静态信息自助获取
  • 酒店账单详情查询
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购三方码方案
  • 综合
  • 能力
  • 历史版本文档(不推荐)
  • 接口说明

    • 将外部酒店静态信息与抖音侧酒店信息进行匹配,返回匹配状态
    • 匹配成功后可使用抖音酒店ID更新酒店静态信息

    基本信息

    名称描述
    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 状态码错误码错误码描述排查建议
    2002100001
    未知错误
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100004
    系统繁忙,此时请开发者稍候再试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100005
    参数不合法
    更换参数
    2002190002
    access_token无效
    调用接口重新生成access_token
    2002190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    2002190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    2002119001
    参数不合法
    更换参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2004000001
    根据实际业务错误返回
    补充参数
    2004000002
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    2003000001
    以实际错误信息为准
    2005000001
    服务器打瞌睡了,请稍后再试。