抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 预置码
  • 批量增加券码
  • 同步订单信息
  • 查询券码对应订单信息
  • 通知增加券码
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 用于通过接口通知三方可用券码不足。

    使用限制

    无

    接口说明

    当预置券码库存低于阈值时,通过接口通知三方可用券码不足。三方可根据实际情况决定是否需要增加券码。

    基本信息

    HTTP URL
    地址由服务商提供
    HTTP Method
    POST
    申请权限
    三方码发布
    权限要求
      •需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案
      •需要url配置,路径:联系抖音对接技术人员,做配置
      •需要商家授权,路径:抖音来客>店铺管理>服务应用授权

    签名规则

    签名规则参考查看 这个地址 的说明

    请求参数

    Body 请求

    参数名称
    类型
    参数描述
    必须
    account_id
    string
    商户ID
    是
    sku_id
    string
    商品ID
    否
    third_sku_id
    string
    三方商品ID
    否
    surplus_qty
    int
    未发放预置码数量
    是
    used_qty
    int
    已发放预置码数量
    是
    expired_qty
    int
    已过期作废预置码数量
    是

    请求示例

    { "account_id": "123", "sku_id": "987665", "third_sku_id": "ab123", "surplus_qty": 500, "used_qty": 50, "expired_qty": 50 }

    响应字段

    字段
    类型
    描述
    data
    object
    ​
    .error_code
    int
    接口错误码,0表示成功 ,-1表示失败(最多重试3次)
    .description
    string
    接口错误描述,失败时带上错误信息

    响应示例

    { "data": { "error_code": 0, "description": "" } }
    ​