抖音开放平台Logo
开发者文档
生活服务商家应用
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 酒店日历房接口
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息自助获取能力
  • 代理商-酒店静态信息自助获取
  • 物理房型静态信息匹配/创建/更新
  • 物理房型静态信息自助获取能力
  • 物理房型上下架能力
  • 售卖房型创建/更新能力
  • 房价/房态/房量更新
  • 日历房价库变更增量通知接口
  • 房量房态推送接口
  • 房价推送接口
  • 价量态接口异步失败通知（WEBHOOK）
  • 酒店会员管理
  • 日历房交易正向
  • 日历房上下架能力
  • 日历房线上开票
  • 入住/离店状态同步能力
  • 营销查询
  • 营销规则价格模式推送
  • 营销规则价格推送
  • 营销价量态拉取
  • 营销库存推送
  • 营销退出报名
  • 主动拉取价量态
  • 创建及修改佣金计划
  • 修改佣金计划状态
  • 根据商品查佣金计划
  • 根据佣金计划查商品
  • 日历房交易逆向
  • 营销规则推送
  • 度假行业解决方案
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

    价量态接口异步更新失败后通知服务商。

    基本信息

    基本信息
    HTTP URL
    --
    HTTP Method
    POST
    Scope
    life.capacity.hotel_ari_async_push
    回调地址配置
    配置webhook地址， event为life_hotel_ari_async_result
    权限要求
    酒店行业日历房解决方案-房价/房态/房量更新能力
    ​

    请求头

    名称
    类型
    必填
    描述
    Msg-Id
    string
    是
    同一实体下同一action的msg_id相同，服务商可根据msg_id对于消息去重
    X-Douyin-Signature
    string
    ​
    是
    抖音侧签名，服务商可根据签名判断该消息是否来自抖音开放平台，抖音服务端会将应用的(client secret + 消息体)使用 sha1 哈希作为 X-Douyin-Signature header 的 value。您可以自行使用 client secret 和收到的消息体进行 sha1 哈希，与该请求头进行比对
    可参考： 文档 - 抖音开放平台 - 服务商平台
    Content-Type
    string
    是
    固定值application/json
    ​

    请求参数

    名称
    类型
    是否必填
    描述
    示例值
    event
    string
    是
    ​
    消息类型，用于区分各类消息，价量态接口异步失败通知的event为life_hotel_ari_async_result
    "life_hotel_ari_async_result"
    ​
    client_key
    string
    是
    对应服务商平台或开发者平台中的APPID，应用ID
    ​
    content
    string
    ​
    是
    ​
    消息内容，根据需要解析消息内容，不同类型的消息内容不同
    ​
    log_id
    string
    是
    抖音内部日志id，可提供给抖音方便排查问题
    ​
    ​

    Content内容

    名称
    类型
    是否必填
    描述
    示例值
    » notify_content
    object
    是
    ​
    ​
    »» account_id
    string
    是
    账户id
    ​
    »» poi_id
    string
    是
    抖音侧poi_id
    ​
    »» room_id
    string
    是
    抖音侧room_id
    ​
    »» rate_plan_id
    string
    是
    返回抖音侧生成的售卖房型id
    ​
    »» time_range_list
    list<object>
    是
    起止时间列表，
      •[start,end]为闭区间，多段日期之间不能重复
    ​
    »»» start
    string
    是
    开始日期 eg. 2024-01-01，不得小于今日
    ​
    »»» end
    string
    是
    结束日期 eg. 2024-01-01，不得小于今日
    ​
    »» from_source
    enum
    是
    推送失败信息来源
    1=房量房态接口 2=房价推送接口
    ​
    » err_code
    enum
    是
    更新保存结果
    ​
    » message
    string
    是
    失败原因
    ​
    ​

    响应参数

    响应内容可以为空。
    开发者收到消息推送后，http code 响应 200 且响应时间小于 3s，抖音侧即认为推送成功。
    若开发者 http 响应 code 非 200 或响应时间超过 3s，抖音侧会间隔 500ms 发起重试，最大重试次数为 3 次。
    抖音侧收到成功请求时也可能会继续重复推送，请务必使用请求头中 Msg-Id 进行消息去重处理。