抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 配送状态变更消息

    收藏
    我的收藏
    抖音侧配送状态变更,平台会同步状态变更消息给第三方系统

    使用限制

    无

    接口说明

    无

    基本信息

    名称
    描述
    Scope
    life.capacity.order.notice
    权限要求
      •需要申请权限 ,路径:抖音开放平台-服务商平台>控制台>应用详情>解决方案
      •需要url配置,路径:抖音开放平台-服务商平台>控制台>应用详情>开发配置>Webhooks
      •需要商家授权,路径:抖音来客>店铺管理>第三方应用授权

    请求头

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

    请求参数

    字段
    类型
    说明
    event
    string
    消息类型,用于区分各类消息
    client_key
    string
    对应服务商平台或开发者平台中的APPID,应用ID
    content
    string
    消息内容,根据需要解析消息内容,不同类型的消息内容不同
    log_id
    string
    抖音内部日志id,可提供给抖音方便排查问题
      •event:life_takeout_delivery_change
      •content内容
    字段
    类型
    说明
    order_id
    string
    订单ID
    poi_id
    string
    门店ID
    delivery_status
    int
    配送状态,枚举如下:
    102: 骑手已接单
    103:骑手已到店
    104:骑手配送中
    200:骑手已送达
    300:运单已撤销
    rider_name
    string
    骑手姓名
    rider_phone
    string
    骑手电话
    update_time
    string
    时间 秒时间戳
    from_third
    bool
    是否来自服务商回传配送状态 true=是

    请求示例

    { "event": "life_takeout_delivery_change", "client_key": "axxxxxxxxxxxxx", "content": "{\"order_id\":\"123124124\",\"poi_id\":\"1231231\",\"delivery_status\":102,\"rider_name\":\"张师傅\",\"rider_phone\":\"13333333333\",\"update_time\":1669348950}", "log_id": "202210101930530102281180650970B5AF" }
    ​