抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮在线点单解决方案
  • 门店接单信息设置
  • 点单相关商品发布
  • 点单相关商品查询
  • 在线点单交易能力
  • 通知外部商家创单
  • 「SPI」通知外部商家订单已关闭
  • 「SPI」通知外部商家支付成功
  • 通知外部商家待接单
  • 「SPI」查询外部商家订单
  • 「SPI」退款结果同步外部商家
  • 「OpenAPI」商家接单/拒单
  • 「OpenAPI」商家回传备餐/出餐/取餐信息
  • 「OpenAPI」商家发起退款
  • 「Webhook」通知外部商家履约备餐状态变更
  • 「OpenAp」点单订单查询
  • 点单查询电话
  • 「SPI」用户申请取消点单
  • 「OpenAPI」点单退款审核回调
  • 商家账单明细
  • 生活服务用户信息转换
  • 随心团解决方案
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

    将生服点单订单的履约备餐状态变更通知外部商家，如备餐中、已出餐、已取餐事件。
    1、消息可能重复推送，请使用 Msg_Id 进行去重处理！
    2、信息推送使用说明参考：生活服务消息推送
    **WebHook消息可能丢失**

    基本信息

    基本信息
    HTTP URL
    --
    HTTP Method
    POST
    Scope
    life.trade.meal_retail_webhook_order_status
    回调地址配置
    配置webhook地址， event为：retail_life_meal_order_status_change

    请求头

    名称
    类型
    必填
    描述
    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
    是
    ​
    消息类型，用于区分各类消息
    ​
    retail_life_meal_order_status_change
    ​
    client_key
    string
    是
    对应服务商平台或开发者平台中的APPID，应用ID
    ​
    content
    string
    是
    ​
    消息内容，根据需要解析消息内容，不同类型的消息内容不同
    ​
    log_id
    string
    是
    抖音内部日志id，可提供给抖音方便排查问题
    ​
    Content内容
    名称
    类型
    是否必填
    描述
    示例值
    order_id
    string
    是
    抖音侧订单 ID
    100001
    timestamp
    int
    是
    状态变更时间戳ms
    ​
    cur_status
    ​
    int
    是
    当前订单状态:
      •10 // 订单已创建（支付前创单）
      •20 // 已支付
      •30 // 待接单
      •40 // 已接单
      •50 // 备餐中
      •51 // 已出餐
      •52 // 已取餐
      •101 // 交易关闭（用户已取消、商家已拒单或已退款
      •1 // 交易完成
    ​
    请求示例

    响应参数

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