抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 通用能力
  • 生活服务交易系统(全融合版)
  • 生活服务交易系统(账号融合版)
  • 错误码和返回码
  • 通用参数
  • 预约
  • 创建预约单
  • 预约接单结果回调
  • 商家取消预约
  • 用户取消预约
  • 查询预约单信息
  • 预约接单超时回调
  • 预约取消/完成通知
  • 查询接口
  • 预下单
  • 营销算价
  • 支付
  • 核销
  • 分账
  • 退货退款
  • poi基础能力
  • CPS佣金设置与查询
  • 核销工具解决方案
  • 历史版本(不推荐使用)
  • 随心团解决方案
  • 垂直行业
  • 其它
  • 开发者可调用该接口取消预约

    使用限制

    接口说明

    基本信息

    名称
    描述
    HTTP URL
    HTTP Method
    POST
    Scope
    industry_open.trade.book
    权限要求
    无需用户授权

    请求头

    请求参数

    名称
    类型
    是否必填
    描述
    book_id
    string
    预约单id,len(book_id) <= 64 byte
    cancel_reason
    string
    取消原因

    请求示例

    curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/merchant_cancel_book' \ --header 'Content-Type: application/json' \ --header 'access_token: xxxxxxxx' --data-raw='{ "book_id" : "mock_book_id", "cancel_reason" : "xxxxxx" }'

    响应参数

    名称
    类型
    是否必填
    描述
    extra
    object
    额外信息

    extra 信息

    名称
    类型
    是否必填
    描述
    示例值
    error_code
    int
    错误码,0为成功
    0
    description
    string
    错误码描述
    success
    sub_error_code
    int
    子错误码
    0
    sub_description
    string
    子错误码描述
    success
    logid
    string
    请求id
    2022092115392201020812109511046
    now
    int
    毫秒级时间戳
    1663745962686

    响应示例

    正常示例

    "extra": { "sub_error_code": 0, "sub_description": "success", "logid": "2022092115392201020812109511046", "now": 1663745962686, "error_code": 0, "description": "success" }

    错误码

    详情参见错误码/返回码