抖音开放平台Logo
开发者文档
生活服务商家应用
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 度假行业解决方案
  • 景区行业解决方案
  • 景区创建订单
  • 景区订单状态查询
  • 景区回调审核退款
  • 景区履约验券
  • 景区确认订单
  • 景区取消订单通知
  • 景区退款结果通知
  • 景区退款审核
  • 景区支付通知
  • 景区预订信息校验
  • 日历票价格库存属性发布
  • 日历票商品查询
  • 三方码发布
  • 日历票商品发布
  • 日历票审核结果同步（webhook）
  • 日历票商品发布
  • 团购核销
  • 门店管理
  • 景区日历票商品类目
  • 通用错误码
  • 综合
  • 历史版本文档（不推荐）
    • 用于商品审核完以后向商家通知审核结果。（WebHook可能丢失）

    接口说明

      •商品创建和更新时抖音会进行商品审核，待商品审核通过后才商家才可以进行价格库存的上传动作，商品审核中时不支持针对同一个商品id做商品更新动作。

    基本信息

    基本信息
    HTTP URL
    --
    HTTP Method
    POST
    Scope
    xxx.xxxxx
    回调地址配置
    配置webhook地址， event为xxxx

    请求头

    名称
    类型
    必填
    描述
    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_scenic_spot_trip_ticket_audit_result
    life_scenic_spot_trip_ticket_audit_result
    ​
    client_key
    string
    是
    对应服务商平台或开发者平台中的APPID，应用ID
    ​
    content
    string
    是
    ​
    消息内容，根据需要解析消息内容，不同类型的消息内容不同
    ​
    log_id
    string
    是
    抖音内部日志id，可提供给抖音方便排查问题
    ​
    Content内容
    名称
    类型
    是否必填
    描述
    示例值
    product_out_id
    string
    否
    商家商品id，更新商品时，ticket_out_id&product_id二选一传入
    ​
    product_id
    string
    是
    ​
    商品id，更新商品时，ticket_out_id&product_id二选一传入
    ​
    ticket_type_out_id
    string
    否
    商家票种id
    ​
    ticket_type_id
    string
    是
    票种id，对应M-Spu
    ​
    ticket_specifications
    list<struct>
    是
    日历票规格，单个商品多规格
    ​
    - sku_id
    string
    是
    日历票规格id，对应sku_id，系统返回
    ​
    - sku_out_id
    string
    否
    商家日历票规格id
    ​
    - ticket_session
    struct
    否
    场次
    ​
    -- ticket_session_name
    string
    是
    场次名字
    ​
    上午场、下午场、夜场票、时间段、单程、往返、自定义
    -- tiket_session_time
    string
    否
    时间
    自定义，最多15个
    - tiket_seat
    string
    否
    坐席
    ​
    普通座、一等座、VIP座
    - tiket_area
    string
    否
    位置
    上行、下行
    status
    ​
    string
    是
    商品审核结果
    ​
    PASS 通过
    FAIL失败
    reason
    string
    否
    审核原因
    ​
    audit_result
    struct
    否
    最近一次的审核结果
    ​
    -is_product_pass
    bool
    是
    商品是否审核通过
    ​
    -product_audit_reason
    string
    否
    商品拒绝原因
    -is_ticket_type_pass
    bool
    是
    票种是否审核通过
    ​
    -ticket_type_audit_reason
    string
    否
    票种审核原因
    ​

    请求示例

    响应参数

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