抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮订座
  • 券资产转移
  • 餐饮门店管理(连锁门店)
  • POI 匹配/申诉(连锁门店)
  • 提交单个门店匹配/匹配申诉任务
  • 查询单个门店匹配/匹配申诉任务结果
  • 门店匹配/匹配申诉任务完成通知
  • POI 信息报错(连锁门店)
  • 门店申诉(连锁门店)
  • 商家账单明细(餐饮行业)
  • 三方码发布
  • 订单查询
  • 餐饮评价
  • 餐饮团购退款
  • 餐饮在线点单解决方案
  • 随心团解决方案
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明

    基本信息

    HTTP URL
    地址由服务商提供
    HTTP Method
    POST
    申请权限
    poi匹配/申诉
    权限要求
    生活服务商家应用,需要url配置,路径:配置方式

    签名规则

    用户可通过请求 header 中的 X-Douyin-Signature 字段判断该消息是否来自抖音开放平台。 抖音服务端会将应用的(client secret + 消息体)使用 sha1 哈希作为 X-Douyin-Signature header 的 value。您可以自行使用 client secret 和收到的消息体进行 sha1 哈希,与该请求头进行比对。

    请求头

    字段
    说明
    Msg-Id
    同一实体下同一action的msg_id相同,服务商可根据msg_id对于消息去重
    X-Douyin-Signature
    抖音侧签名,服务商可根据签名判断该消息是否来自抖音开放平台
    Content-Type
    固定值application/json

    Body 请求

    名称
    类型
    说明
    content
    struct
    task_id
    string
    匹配/匹配申诉任务id
    status
    string
    状态 匹配成功 匹配失败
    client_key
    int
    对应服务商平台或开发者平台中的APPID,应用ID
    event
    string
    消息类型,用于区分各类消息,event=life_poi_match_notify
    log_id
    string
    抖音内部日志Id 用于排查错误