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

请求头

请求参数

Body 请求

参数名称	参数类型	参数描述
poi_id	string	抖音门店id
start_time	int64	开始时间戳，s为单位
end_time	int64	结束时间戳，s为单位

备注：字段描述备注了（加密）的字段，需要进行字段解密方可看到字段信息，如何解密请参考本文最下方内容

请求示例

{
  "poi_id": "poi_id",
  "start_time":1699977600, //2023-11-15 00:00:00
  "end_time": 1700064000   //2023-11-15 23:59:59
}

响应参数

参数名称	参数类型	参数描述
data	struct
.error_code	int32	失败错误码，失败必填
.description	string	失败原因
.values	list
..start_time	string	开始时间
..end_time	string	结束时间
..tables	list
...type_id	string	桌台规格id
...location_type	int32	桌台类型（大厅-0 包间-1）
...start_time	string	开始时间（同个桌台同一天不可重复）
...end_time	string	结束时间（同个桌台同一天不可重复）
...min_people	int32	最小可订人数
...max_people	int32	最大可订人数
...people_num	int32	桌台人数
...used_quantity	int32	已用库存
...reserve_quantity	int32	预留库存

响应示例

正常示例

{
  "data": {
    "error_code": 0,
    "description": "success",
    "values": [
    {
     "start_time": "00:00",
     "end_time": "23:00",
     "tables": [
       {
         "type_id": 1083,
         "location_type": 1, // 0-大厅 1-包间
         "start_time": "00:00",
         "end_time": "23:00",
         "people_num": 6,
         "used_quantity": 0,
         "reserve_quantity": 10
       }
     ]
   }]
  }
}

异常示例

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

错误码

HTTP 状态码	错误码	描述	排查建议
200	xxxxxx	服务商自定义（需满足 0~999999)	无

查询桌台实时库存收藏我的收藏

使用限制

接口说明

基本信息

请求头

请求参数

Body 请求

请求示例

响应参数

响应示例

正常示例

异常示例

错误码

查询桌台实时库存
收藏
我的收藏