基础能力

触达与营销

支付

运营

生活服务

通用能力

生活服务交易系统（全融合版）

生活服务交易系统（账号融合版）

预约

查询接口

预下单

营销算价

支付

核销

分账

退货退款

poi基础能力

CPS佣金设置与查询

核销工具解决方案

历史版本（不推荐使用）

随心团解决方案

垂直行业

其它

查询预约单信息

我的收藏

开发者可调用该接口查询预约信息。

book_id 与 order_id 二选一，传入 book_id 的话，只会返回这一个预约单的信息。传入 order_id，会返回这个 order_id 关联的所有预约单信息。都填的话，order_id 生效

使用限制

无

接口说明

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/trade/v2/book/query_book
HTTP Method	POST
Scope	industry_open.trade.book
权限要求	•无需用户授权

请求头

参考通用参数

请求参数

名称	类型	必填	描述
order_id	string	否	抖音侧订单号，len(order_id) <= 64 byte
book_id	string	否	预约单号，len(book_id) <= 64 byte

请求示例

curl --location --request POST 'https://developer.toutiao.com/api/apps/trade/v2/query_book' \
--header 'Content-Type: application/json' \
--header 'access_token: xxxxxxxxxx'
--data-raw='{
    "book_id" : "mock_book_id",
    "order_id" : "xxxxxxxxxx"
}'

响应参数

名称	类型	是否必填	描述
data	Json<object>	否	返回数据信息
extra	object	是	额外信息

data 字段说明

名称	类型	是否必填	描述
book_info_list	Array<object>	否	预约单信息，详见BookInfo

BookInfo 字段说明

名称	类型	是否必填	描述
book_id	string	是	预约单号，len <= 64 byte
order_id	string	是	商户单号，len <= 64 byte
status	string	是	预约状态 BOOKING 预约中 SUCCESS 预约成功 FINISH 预约完成(已核销） CANCEL 预约取消 FAIL 预约失败
book_child_info_list	Array<object>	是	预约子单信息，详见BookChildInfo
markup_order_id	string	否	该预约单关联的加价单id，len <= 64 byte
out_book_no	string	是	外部预约单号，len <= 64 byte

BookChildInfo 字段说明

名称	类型	是否必填	描述
goods_id	string	是	商品id，len <= 64 byte
sku_id	string	否	商品sku_id，len <= 64 byte
item_order_id	string	是	item单号，len <= 64 byte
poi_id	string	是	预约的poi id，实际存储的是int64类型的值
book_start_time	int64	是	预约的开始时间（ms）
book_end_time	int64	是	预约结束时间（ms）
user_info_list	Array<object>	是	用户信息，详见UserInfo
markup_item_order_id	string	否	该预约单关联的加价单item_order_id，，len <= 64 byte

UserInfo 字段说明

名称	类型	是否必填	描述
name	string	否	使用人名称，len <= 128 byte
phone	string	否	电话号码
id_card_no	string	否	身份证号码

响应示例

正常示例

{
    "data": {
        "book_info_list": [
        {
            "book_id": "ot7117205804150901036",
            "order_id": "ot7117226212715923756",
            "out_book_no": "zxsw4443rette54ert53",
            "status": "BOOKING",
            "book_child_info_list": [
                {
                    "book_end_time": 1657111979000,
                    "book_start_time": 1657111978000,
                    "goods_id": "711679988841900",
                    "item_order_id": "ot7117226212715989292",
                    "poi_id": 4355,
                    "user_info_list": [
                        {
                            "id_card_no": "123456789012345678",
                            "name": "zxs",
                            "phone": "12321234322"
                        }
                    ]
                },
                {
                    "book_end_time": 1657111979000,
                    "book_start_time": 1657111978000,
                    "goods_id": "711679988841900",
                    "item_order_id": "ot71172262127667772",
                    "poi_id": 4355,
                    "user_info_list": [
                        {
                            "id_card_no": "123456789012345678",
                            "name": "zxs",
                            "phone": "12321234322"
                        }
                    ]
                }
            ]
        }
      ]
    }，
    "extra": {
    "sub_error_code": 0,
    "sub_description": "success",
    "logid": "2022092115392201020812109511046",
    "now": 1663745962686,
    "error_code": 0,
    "description": "success"
  }
}

错误码

详情参见错误码/返回码。