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

    • 使用限制

    无

    接口说明

      1.抖音用户下预定单时，抖音会调服务商校验是否可订
      2.SPI 超时响应时间为 1700ms，超时响应则会自动流转到可订；
      3.服务商可订校验接口系统异常，自动流转到可订

    基本信息

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

    请求头

    请求参数

    Body 请求

    参数名称
    参数类型
    参数描述
    request_id
    string
    请求ID
    poi_id
    string
    抖音门店id
    participant_number
    int32
    就餐人数
    dinning_time
    string
    就餐时间 格式:2017-5-19 10:49:00
    location_type
    ​
    string
    （大厅-0 包间-1 其他-3）
    contact_phone
    String
    预定手机（加密）
    备注：字段描述备注了（加密）的字段，需要进行字段解密方可看到字段信息，如何解密请参考本文最下方内容

    请求示例

    {
  "poi_id": "poi_id",
  "dinning_number": 1,
  "dinning_time": "2017-5-19 10:49:00",
  "location_type": "1"
}

    响应参数

    参数名称
    参数类型
    参数描述
    data
    struct
    .error_code
    int32
    失败错误码，失败必填
    .description
    string
    失败原因
    .result
    int32
    确认结果. 1:允许下单,2:不可下单
    .fail_code
    int32
    如果不可下单，返回原因code（枚举见下表）
    .other_fail_msg
    ​
    string
    如果不可下单的原因不在枚举范围内，用该字段返回原因

    响应示例

    正常示例

    {
  "data": {
    "error_code": 0,
    "description": "success",
    "result": "2",
    "fail_code": 1
  }
}

    异常示例

    {
  "data": {
    "error_code": 20,
    "description": "系统异常"
  }
}

    错误码

    HTTP 状态码
    错误码
    描述
    排查建议
    200
    1
    门店未开通预定
    ​
    200
    2
    没有匹配的桌型
    ​
    200
    3
    该桌型已订满
    ​
    200
    4
    超出门店营业时间
    ​
    200
    5
    门店无法正常营业
    ​
    200
    20
    其他异常（服务商自定义，不透传给用户）
    ​
    ​