抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 预售券确认接单
  • 预售券查询订单poi
  • 预售券价量态-更新预售商品价库及属性
  • 预售券价量态-获取预售券商品价量态
  • 酒旅日历房解决方案
  • 根据商品查佣金计划
  • 创建及修改佣金计划
  • 佣金计划创建与修改
  • 佣金计划创建结果推送(webhook)
  • 修改佣金计划状态
  • 通用能力
  • 接入前准备
  • 接口说明

    异步创建佣金计划场景下,对创建接口进行推送。目前门店维度下的通用计划创建会进行异步通知,且会通知多次,用于给门店下每个商品创建对应的通用计划。

    基本信息

    基本信息
    HTTP Method
    POST
    回调地址配置
    配置webhook回调地址, event为 life_hotel_commission_rate_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_commission_rate_result
    life_hotel_commission_rate_result
    ​
    client_key
    string
    是
    对应服务商平台或开发者平台中的APPID,应用ID
    ​
    content
    string
    是
    ​
    消息内容,json字符串。根据需要解析消息内容,不同类型的消息内容不同
    ​
    log_id
    string
    是
    抖音内部日志id,可提供给抖音方便排查问题
    ​

    Content内容

    参数名称
    参数类型
    必须参数
    备注
    » dimension_type
    enum
    必填
    维度
    » dimension_id
    string
    必填
    维度id
    » code
    int
    必填
    创建结果状态码
      •0:表示成功
      •非0:表示失败
    » message
    string
    必填
    文案说明
    » plan_ids
    list<string>
    选填
    创建成功的计划id列表

    响应参数

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