抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮订座
  • 批量配置订座
  • 查询订座配置任务结果
  • 订座配置任务完成通知
  • 商户订座业务变更通知
  • 门店订座配置变更
  • 库存变更通知
  • 查询桌台实时库存
  • 查询是否可订
  • 下预订单
  • 手动接单
  • 取消预订
  • 预订单状态变更通知
  • 用户到店确认
  • 券资产转移
  • 餐饮门店管理(连锁门店)
  • POI 匹配/申诉(连锁门店)
  • POI 信息报错(连锁门店)
  • 门店申诉(连锁门店)
  • 商家账单明细(餐饮行业)
  • 三方码发布
  • 订单查询
  • 餐饮评价
  • 餐饮团购退款
  • 餐饮在线点单解决方案
  • 随心团解决方案
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 使用限制

    接口说明

    用户在抖音APP取消订座后,抖音会调商家接口取消预定

    基本信息

    HTTP URL
    地址由服务商提供
    HTTP Method
    POST
    权限要求
      需要申请权限 ,路径:抖音开放平台-服务商平台>控制台>应用详情>解决方案
      需要url配置,路径:见下方“服务商/商家侧SPI接口配置”
      需要商家授权,路径:抖音来客>店铺管理>服务应用授权

    请求头

    请求参数

    Body 请求

    参数名称
    参数类型
    参数描述
    request_id
    string
    请求ID
    order_id
    string
    抖音订单id
    ext_order_id
    string
    第三方订单id
    cancel_time
    int64
    取消时间戳
    cancel_reason
    string
    取消原因
    备注:字段描述备注了(加密)的字段,需要进行字段解密方可看到字段信息,如何解密请参考本文最下方内容

    请求示例

    { "request_id": "request_id", "order_id": "order_id", "ext_order_id": "ext_order_id", "cancel_time": 0, "cancel_reason": "临时有事" }

    响应参数

    参数名称
    参数类型
    参数描述
    data
    struct
    .error_code
    int32
    失败错误码,失败必填
    .description
    string
    失败原因

    响应示例

    正常示例

    { "data": { "error_code": 0, "description": "success" } }

    异常示例

    { "data": { "error_code": 1, "description": "error" } }

    错误码

    HTTP 状态码
    错误码
    描述
    排查建议
    200
    非0
    商户自定义