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

    暂无

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/api/life/v1/fulfill/service_confirm/
    HTTP Method
    POST
    Scope
    open.industry.life_trade_api.service_confirm

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    固定值"application/json"
    Rpc-Transit-Life-AccountString

    来客商户根账户ID

    Body
    book_idString
    商户单id
    verify_id_listArray<Int64>
    代表券码一次核销的唯一标识
    请求示例
    curl --location --request POST 'https://open.douyin.com/api/life/v1/fulfill/service_confirm/' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{"verify_id_list":[3806923641419693325],"book_id":"C7vBfEF389"}'

    响应参数

    Body
    err_msg必填String
    err_no必填Int32
    log_id必填String
    响应示例
    正常响应示例异常响应示例
    { "err_no": 7463968156555974000, "err_msg": "F5cTYI5l8h", "log_id": "uWS0khTvnu" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2002119001
    参数不合法
    更换参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    20028001003
    access_token无效
    调用接口重新生成access_token
    20028001005
    系统内部错误,请重试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    20028001006
    网络调用错误,请重试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    20028001007
    参数不合法
    请根据错误信息更换参数
    20028001008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    20028001013
    目标用户未授权相关scope
    请检查用户是否授权
    20028001014
    应用未授权任何能力
    应用申请接口权限
    20028001015
    access_token与openid不匹配
    请检查用户数据是否正确
    20028001016
    当前应用已被封禁或下线
    请联系应用开发者排查
    20028001017
    未知URI
    请检查URI 是否拼写错误,或联系抖音排查
    20028001018
    应用未获得该能力
    应用申请接口权限
    20028001019
    应用该能力已被封禁
    该能力被封禁,联系平台处理
    20028003017
    quota已用完
    调用次数已超过当日限额
    20028003018
    请求频率过高
    请稍后重试