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

    收藏
    我的收藏
    用于预置码批量创建创建券码。

    使用限制

    无

    接口说明

    商家/服务商通过该接口提前将生成的券码同步至抖音侧进行存储。一次导入最多 500 个,抖音侧会对每一批次的券码进行验重,如果当前券码存在重复,那么这一批次的券码均会同步失败,故需要三方确保同步的券码是唯一不重复的。

    基本信息

    HTTP URL
    https://open.douyin.com/goodlife/v1/fulfilment/reserve_code/batch_import/
    HTTP Method
    POST
    申请权限
    三方码发布
    权限要求
      •需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案
      •需要商家授权,路径:抖音来客>店铺管理>服务应用授权

    请求头

    参数
    描述
    必须
    Content-Type
    application/json
    是
    access-token
    根据这个地址获取的token
    是

    请求参数

    Body 请求

    参数名称
    类型
    参数描述
    必须
    account_id
    string
    商户ID
    是
    sku_id
    string
    商品ID
    否
    third_sku_id
    string
    三方商品ID
    否
    codes
    list(string)
    未发放预置码
    是
    expired_time
    int64
    码过期秒时间戳
    否

    请求示例

    { "account_id": "123", "sku_id": "987665", "third_sku_id": "ab123", "codes": ["x1", "x2"], "expired_time": 1658914935 }

    响应参数

    字段
    类型
    描述
    必须
    extra
    object
    ​
    是
    .error_code
    int64
    接口错误码 0代表成功 todo:错误码
    是
    .description
    string
    接口错误描述
    否
    .logid
    string
    抖音侧排查问题的标示
    是
    .now
    int64
    (弃用)响应秒时间戳
    是

    响应示例

    { "extra": { "error_code": 0, "description": "success", "logid": "2020070614111601022506808001045D59", "now": 1651131270 } }

    错误码

    HTTP 状态码
    错误码
    错误消息
    排查建议
    200
    2190002
    access_token无效
    调用接口重新生成access_token
    200
    2190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    200
    2190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    200
    2119001
    参数不合法
    更换参数
    200
    2119002
    系统繁忙,请稍候再试
    重试
    200
    2119003
    请求太过频繁,请稍后再试
    重试
    200
    2119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    200
    3000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    200
    4000001
    补充参数
    200
    4000002
    同步的券码有重复,对照接口文档规范参数并重试
    200
    5000001
    联系抖音处理
    ​