抖音
  1. 生活服务交易系统(账号融合版)
抖音
  • 简介
  • 签名算法
  • 接口调用凭证
    • 经营能力调用凭证
      • BusinessToken 生成
      • BusinessToken 刷新
      • 经营能力当前状态查询
    • 非用户授权调用凭证
      • 获取应用授权调用凭证
      • getAccessToken
    • 用户授权调用凭证
      • 获取用户授权调用凭证
      • 刷新用户授权调用凭证
      • 刷新授权调用凭证
  • 登录
    • code2Session
      POST
  • 小程序码与小程序链接
    • Schema 链接
      • 生成SchemaV2
      • 查询SchemaV2
      • 查询Schema配额V2
    • Link链接
      • 生成 Link V2
      • 查询 Link 配额V2
      • 查询 Link V2
    • 二维码
      • 生成QRCodeV2
  • 私域经营
    • 私信管理
      • IM主动授权webhook
      • 主动发送私信
    • 群聊管理
      • 粉丝群webhook
        • 用户加群申请 webhook
        • 用户加群webhook
      • 查询群信息
      • 设置进群问候语&群公告
      • 创建粉丝群
      • 取消进群问候语&群公告配置
      • 变更用户入群申请状态
      • 查询用户剩余建群额度
      • 查询群主所在群的用户入群申请状态
    • 经营工具
      • 小程序引导卡片
        • 创建/更新小程序引导卡片模板
        • 查询小程序引导卡片模板
        • 删除小程序引导卡片模板
      • 图片上传
  • 线索组建
    • 创建线索组件
    • 查询已创建的线索组件
    • 更新线索组件
    • 删除线索组件
  • 视频能力
    • 视频数据查询
      • 查询特定视频的视频数据
    • 近 30 天用户视频数据
      • 获取视频基础数据
      • 获取视频点赞数据
      • 获取视频评论数据
      • 获取视频播放数据
      • 获取视频分享数据
    • 视频评论数据
      • 置顶评论
      • 评论回复列表
      • 评论列表
      • 回复视频评论
    • videoid转换itemid
    • itemid转换encryptid
  • 搜索能力
    • 创建抖音搜索直达子服务
    • 查询已创建的抖音搜索直达子服务列表
    • 删除抖音搜索直达子服务
    • 校验是否有搜索直达服务的创建权限
  • 电商
    • 注册小程序积分阈值
    • 注册小程序预览图
    • 查询订单的定制完成状态
    • 定制类小程序开发者注册信息
    • 退会
  • 生活服务
    • 店铺接入
      • 商铺同步
      • 查询店铺
      • 获取抖音POI ID
      • 店铺匹配任务结果查询
      • 店铺匹配状态查询
      • 提交门店匹配任务
      • 查询全部店铺信息接口(天级别请求5次)
      • 查询店铺全部信息任务返回内容
    • 商品库接入
      • (老版本)SKU同步
      • (老版本)sku拉取(该接口由接入方实现)
      • (老版本)多门店SPU同步
      • (老版本)多门店SPU状态同步
      • (老版本)多门店SPU库存同步
      • (老版本)多门店SPU信息查询
      • 创建/修改团购商品
      • 免审修改商品
      • 上下架商品
      • 同步库存
      • 查询商品模板
      • 查询商品草稿数据
      • 查询商品线上数据
      • 查询商品线上数据列表
      • 查询商品草稿数据列表
      • 用于创建多 SKU 商品。
      • 查询商品品类
    • 端内消息同步
      • 订单同步
    • poi数据接入
      • 获取POI基础数据
      • POI用户数据
      • POI服务基础数据
      • POI服务成交用户数据
      • POI热度榜
      • POI认领列表
    • poi基础能力
      • 通过高德POI ID获取抖音POI ID
    • 优惠卷接入
      • 优惠券同步
      • 优惠券更新
    • CPS佣金设置与查询
      • 通用佣金计划查询带货数据
      • 通用佣金计划查询达人带货数据
      • 通用佣金计划查询带货达人列表
      • 通用佣金计划查询达人带货详情
      • 查询通用佣金计划
      • 发布/修改通用佣金计划
      • 修改通用佣金计划状态
      • 发布/修改直播间定向佣金计划
      • 发布/修改短视频定向佣金计划
      • 修改定向佣金计划状态
      • 取消定向佣金计划指定的达人
      • 查询达人的定向佣金计划带货数据
      • 通过商品 ID 查询定向佣金计划
      • 查询定向佣金计划带货汇总数据
  • 用户信息
    • 用户抖音主页数据
      • 获取用户视频情况
      • 获取用户粉丝数
      • 获取用户点赞数
      • 获取用户评论数
      • 获取用户分享数
      • 获取用户主页访问数
  • 分享
    • 拍抖音任务
      • 拍抖音任务变更推送
      • 创建任务
      • 查询用户任务进度
    • 拍抖音互动任务
      • 拍抖音互动任务变更推送
      • 创建任务
      • 查询用户任务进度
    • 分享任务
      • 创建任务
      • 查询用户任务进度
  • 客服
    • CustomerServiceUrl
  • 小程序卷
    • 「小程序券」直播玩法接入指南
    • 小程序券API列表
    • 更新日志
    • 用户卷管理
      • 查询用户可用券信息
      • 用户领券结果回调通知
      • 用户撤销核销券
      • 用户手机号授权结果回调通知
      • 用户核销券
    • 主播授权管理
      • 查询主播发券配置信息
      • 修改主播发券权限状态
      • 更新主播发券库存上限
      • 主播发券权限配置
    • 卷模版管理
      • 查询授权用户发放的活动信息
      • 创建券模板
      • 修改券模板
      • 删除券模板
      • 修改券模板库存
      • 修改券模板状态
      • 查询券模板发放统计数据
      • 查询券模板
      • 查询对账单
    • 接口发放管理
      • 创建开发者接口发券活动
      • 开发者接口发券
      • 删除开发者接口发券活动
  • 交易系统
    • 通用交易系统
      • 通用参数
      • 进件
        • 接口进件
          • 图片上传
          • 发起进件
          • 进件查询
        • 获取进件页面链接
          • 开发者获取小程序收款商户/合作方进件页面
          • 服务商获取小程序收款商户进件页面
          • 服务商获取服务商进件页面
          • 服务商获取合作方进件页面
      • 标签
        • 查询标签组信息
      • 订单
        • 查询CPS信息
        • 查询订单信息
        • 支付结果回调
      • 退款
        • 发起退款
        • 查询退款
        • 同步退款审核结果
        • 退款申请回调扩展点
        • 退款结果通知
      • 履约
        • 推送履约状态
      • 结算
        • 发起分账
        • 查询分账
        • 通知分账结果
      • 提现
        • 接口提现
          • 商户余额查询
          • 商户提现
          • 商户提现结果查询
        • 获取提现页面链接
          • 开发者获取小程序收款商户/合作方提现页面
          • 服务商获取小程序收款商户提现页面
          • 服务商获取服务商提现页面
          • 服务商获取合作方提现页面
      • 获取对账单
        • 获取资金账单
        • 获取交易账单
    • 生活服务交易系统(金融合板)
      • 通用参数
      • 错误码和返回码
      • 查询接口
        • 查询订单信息
        • 查询券状态信息
        • 查询 CPS 信息
      • 预下单
        • 预下单扩展点
        • 开发者发起下单
      • 营销算价
        • 营销算价扩展点介绍
        • 查询营销算价扩展点
      • 支付
        • 支付结果通知
      • 核销
        • 抖音码
          • 验券准备
          • 验券
          • 撤销核销
          • 券码核销通知
          • 撤销核销通知
        • 三方码
          • 推送核销状态
          • 撤销核销
      • 分账
        • 查询分账
      • 退货退款
        • 开发者发起退款
        • 同步退款审核结果
        • 查询退款
        • 退款扩展点
        • 退款结果通知
    • 生活服务交易系统(账号融合版)
      • 错误码和返回码
      • 通用参数
      • 预约
        • 创建预约单
        • 预约接单结果回调
        • 商家取消预约
        • 用户取消预约
        • 查询预约单信息
        • 预约接单超时回调
        • 预约取消/完成通知
      • 查询接口
        • 查询订单信息
        • 查询券状态信息
        • 查询CPS信息
      • 预下单
        • 预下单回调
        • 关闭订单
        • 发起下单
      • 营销算价
        • 营销算价扩展点介绍
        • 查询营销信息扩展点
        • 算价扩展点
        • 营销查询算价二合一
      • 支付
        • 通知支付结果
      • 核销
        • 抖音码
          • 验券准备
          • 验券
        • 三方码
          • 推送核销状态
        • 核销工具
          • 查询用户券列表
          • 查询订单可用门店
          • 券核销消息通知
          • 撤销核销消息通知
          • 设置商家展示信息
          • 查询商家配置文案
          • 设置订单详情页按钮白名单接口
          • 设置小程序跳转path
      • 分账
        • 发起分账
        • 查询分账
        • 通知分账结果
      • 退货退款
        • 发起退款
        • 同步退款审核结果
        • 查询退款
        • 退款申请回调
        • 通知退款结果
    • 行业交易系统
      • API 调用
        • 通用参数
        • 错误码和返回码
      • 回调设置
        • 设置回调地址
        • 查询回调地址
      • 预下单
        • 查询 CPS 信息
        • 查询订单信息
        • 预下单回调
        • 开发者发起下单
      • 营销算价
        • 营销算价扩展点介绍
        • 查询营销信息扩展点
        • 设置扩展点
        • 算价扩展点
    • 支付
      • 通知支付结果
    • 核销
      • 抖音码
        • 验券准备
        • 验券
        • 查询劵状态信息
      • 三方码
        • 推送核销状态
      • 分账
        • 发起分账
        • 查询分账
        • 通知分账结果
    • 提货退款
      • 开发者发起退款
      • 同步退款审核结果
      • 查询退款
      • 退款申请回调
      • 通知退款结果
  • 内容安全
    • 内容安全检测
    • 图片检测V2
    • 图片检测V3
  • 泛知识
    • 角色系统
      • 错误码
      • 上传材料
      • 代运营服务商帮老师或代运营模式机构入驻
      • 自营机构/服务商入驻
      • 新增角色
      • 查询基础认证资质
      • 更新基础认证资质
      • 查询类目认证资质
      • 更新类目认证资质
      • 添加类目认证资质
      • 获取审核任务详情
      • 小程序绑定角色
      • 小程序解除绑定角色
      • 查询小程序已绑定的角色
      • 角色授权小程序
      • 解除授权小程序
      • 查询授权小程序
      • 更新授权小程序授权信息
      • 查询抖音号绑定、能力授权
      • 新增抖音号绑定、能力授权
      • 解除抖音号绑定、解除能力授权
      • 查询实体ID
      • 查询实体已绑定抖音号列表
    • 课程库
      • 【泛知识】回调通知
      • 【泛知识】课程库 FAQ
      • 【泛知识】错误码
      • 【泛知识】上传课程资源
      • 【泛知识】查询课程资源上传状态
      • 【泛知识】查询资质
      • 【泛知识】添加课程
      • 【泛知识】修改课程
      • 【泛知识】修改课程状态
      • 【泛知识】查询课程
      • 【泛知识】修改课程免审
      • 【泛知识】查询免审课程
      • 【泛知识】修改商品退款规则
      • 【泛知识】查询可选退款规则
      • 【泛知识】查询课程类目信息
  • 担任支付
    • 进件
      • 进件状态回调
      • 发起进件请求
      • 图片上传接口
      • 进件状态查询
    • 支付
      • 支付结果回调
      • 支付常见问题
      • 预下单接口
      • 唤起收银台
      • 支付结果查询
    • 退款
      • 退款结果回调
      • 退款常见问题
      • 发起退款
      • 退款结果查询
    • 结算及分账
      • 收费规则
      • 结算及分账常见问题
      • 自动结算
        • 自动结算接入说明
        • 自动结算结果回调
        • 自动结算结果查询
      • 发起结算及分账
      • 结算及分账结果查询
      • 结算及分账结果回调
      • 可分账余额查询
    • 退分账
      • 发起退分账
      • 查询分账回退结果
    • 提现
      • 商户余额查询
      • 商户提现
      • 商户提现结果查询
      • 商户提现回调
    • 获取对账单
      • 获取交易账单
      • 获取资金账单
    • 接口获取页面链接
      • 进件
        • 开发者获取小程序收款商户/合作方进件页面
        • 服务商获取小程序收款商户进件页面
        • 服务商获取服务商进件页面
        • 服务商获取合作方进件页面
      • 提取
        • 开发者获取小程序收款商户/合作方提现页面
        • 服务商获取小程序收款商户提现页面
        • 服务商获取服务商提现页面
        • 服务商获取合作方提现页面
    • 订单推送
      • 订单同步
  • 评价
    • 获取评价数据
  • 其他
    • 用户登录态签名
    • 抖音开放平台与小程序视频打通能力
      • 抖音开放平台与小程序视频打通能力
      • 视频使用能力能力
    • 开放能力配置接口
      • 开放能力配置接口
      • 配置开放能力实现接口
      • 查询生效中配置接口
    • 解决方案测试实体管理接口
      • 解决方案测试实体管理接口
      • 新增测试实体接口
      • 查询测试实体接口
      • 删除测试实体接口
    • 直播间自定义封面
    • 上传资源
    • 能力申请
    • 查询能力申请状态
  • 订阅消息
    • 查询订阅消息模版库
    • 发送订阅消息
    • 查询小程序的模版列表
    • 添加模板
    • 删除已添加的模版
    • 查询新建订阅消息模板列表
    • 新建订阅消息模板
  • 小程序推广计划
    • 短视频任务
      • 创建任务
        • 小程序任务台能力
        • 创建任务
      • 查询任务台任务投稿视频数据(明细)
      • 查询任务台任务投稿视频数据
      • 查询小程序任务台任务 ID
      • 更新任务状态
      • 重新提交任务基础信息
      • 查询任务详情
      • 更新专属任务达人
      • 查询视频任务相关实时汇总数据
    • 直播间任务
      • 创建直播间任务
      • 更新直播间任务
  • 挂载
    • 自主挂载
      • 获取作者视频列表
      • 自主挂载存量视频绑定锚点
      • 自主挂载存量视频解绑锚点
    • 小程序直播挂载黑白名单管理能力
    • 拍抖音黑白名单管理能力
    • 申请短视频自主挂载能力
    • 查询短视频自主挂载能力申请状态
    • 申请直播自主挂载能力
    • 查询直播自主挂载能力申请状态
    • 申请短视频达人推广挂载能力
    • 查询短视频达人推广挂载能力申请状态
    • 查询直播达人推广挂载能力申请状态
    • 申请直播达人推广挂载能力
    • 短视频/直播自主挂载能力绑定抖音号
    • 获取短视频/直播自主挂载抖音号绑定二维码
    • 查询短视频/直播自主挂载能力绑定抖音号列表
    • 解除短视频/直播自主挂载能力抖音号绑定
    • 挂载权限校验
    • 修改短视频锚点配置
    • 查询短视频锚点配置
    • 查询短视频锚点配置修改记录及状态
    • 图片上传
    • 图片审核状态查询
    • 图片删除
    • 设置全局默认配置
    • 设置指定页面配置
    • 查询全局默认配置
    • 查询指定页面配置
    • 删除指定页面配置
    • 讲解卡动态更新
  • 分发
    • 添加小程序别名
    • 查询小程序别名
    • 修改小程序别名
    • 删除小程序别名
    • 设置小程序搜索标签
    • 查询小程序搜索标签列表
  • 引导关注抖音号
    • 绑定抖音号
    • 获取抖音号绑定二维码
    • 获取绑定抖音号列表
    • 解除抖音号绑定
  • 数据分析
    • 用户分析
      • 行为分析
      • 实时分析
      • 留存分析
      • 来源分析
      • 用户画像
      • 终端分析
      • 页面分析
    • 交易分析
      • 总览分析
      • 流量转化
      • 短视频交易分析
      • 获取直播房间数据
      • 直播数据分析
      • 直播交易分析
      • 商品分析
    • 短视频分析
      • 短视频投稿数据
      • 短视频总览数据
      • 短视频详细数据
      • 流量来源
    • 直播分析
      • 直播间详细数据
        • 接口 1
        • 接口 2
      • 直播间总览数据
      • 主播分析
    • 小房子直播分析
      • 小房子直播间总览数据
      • 小房子直播间详细数据
      • 小房子直播间订单数据
    • 留资分析
      • 组件使用数据
      • 流量来源
      • 组件详细数据
      • 组件使用对比
  • 服务类目
    • 获取已设置的服务类目
  • 直播间能力
    • 查询跳转抖音直播间能力申请状态
    • 申请跳转抖音直播间能力
    • 查询直播间状态组件能力申请状态
    • 申请直播间状态组件能力
  • 抖音开放能力
    • 查询抖音开放能力列表
    • 申请开通抖音开放能力
    • 查询scope配额详情
    • scope申请提额
    • 查询视频关键词列表
    • 新增视频关键词
    • 删除视频关键词
  • 页面结构自定义
    • 查询页面结构自定义能力申请状态
    • 申请页面结构自定义能力
  • 普通二维码绑定
    • 查询普通二维码绑定列表
    • 新增绑定二维码
    • 更新绑定二维码链接
    • 更新绑定二维码状态
    • 删除绑定二维码链接
  • 抖音号绑定
    • 获取抖音号绑定所需的资质模版列表
    • 获取抖音号绑定所需的资质模版信息
    • 输入抖音号绑定
    • 获取抖音号绑定二维码
    • 查询抖音号绑定列表及状态
    • 解除抖音号绑定
  • 流量主
    • 查询流量主开通状态
    • 开通流量主
    • 查询广告位列表
    • 新增广告位
    • 更新广告位状态
    • 查询广告收入
    • 查询广告结算单列表
  • 抖店绑定
    • 绑定抖店开放平台账号
    • 查询绑定的抖店开放平台账号信息
    • 配置抖店开放平台应用
    • 查询配置的抖店开放平台应用信息
    • 获取绑定抖店账号信息
  1. 生活服务交易系统(账号融合版)

错误码和返回码

OpenAPI 父错误码 error_code

error_codedescription常见原因和解决办法
0success成功
2100004系统繁忙,此时请开发者稍候再试检查参数类型是否与文档要求一致。如果参数类型不一致,一般会报此错误
2100005参数不合法检查是否必填等
2100007无权限操作
2190002access_token无效检查access_token
2190004应用未获得该能力, 请去https://open.douyin.com/申请检查scope权限
2190008access_token过期,请刷新或重新授权
2191000内部错误
2191001风控类错误
2191002通用交易类错误
2191003正向交易类错误
2191004核销类错误
2191005逆向交易类错误
2191006资金类错误
2191007外部扩展相关错误
2191008营销优惠相关错误
2191009分账类错误

OpenAPI 子错误码 sub_error_code

sub_error_code含义常见原因和解决办法
10000参数错误传入了非法参数,一般返回的错误说明中会有明确指示哪里出错了
13000内部服务错误一般是平台内部系统出错了,大部分是超时,这个超时可能是由调用开发者的系统间接导致的,如果重试无法解决请提供logid走oncall流程
10002参数解析错误开发者参数的格式错误,请对照api文档自查格式是否正确
11001访问未授权如果是查询接口,访问的数据不属于当前用户或者小程序,属于非法访问 如果是前端JS API接口,没有使用JS API的权限,需要联系相关对接人添加权限
11002AccessToken非法一般是AccessToken过期了,请刷新AccessToken
11003Session非法一般是用户session过期了,请尝试重新登录一下
11004签名校验失败
11005用户未登录
11006商服关系未授权检查服务商和商家的商服关系是否建立与授权
12001访问过于频繁风控类错误,用户访问过于频繁,系统会进行拦截,请等一会重试
12002用户账号异常系统风控判断用户账号存在风险行为,请等一会重试,如果无法解决请提供logid走oncall流程
20000订单不存在系统未查询到对应的订单信息,请检查订单的id是否真实存在
20001订单状态不正确一般是当前订单所处的状态无法执行当前的操作,如对未支付的订单执行核销操作就会报这种错误
20002商品不存在交易中使用的商品不存在于商品库中
20003POI不存在交易中传入的poiid不存在
20004订单没有cps相关信息
20005查询订单信息失败
21000商品单与商户单不匹配请求参数非法,存在非此商户单的 商品单,请检查请求参数
21001商品单状态不支持核销该商品单不是待使用状态,或已经退款,请检查请求参数
21003该应用不在灰度白名单一般是该应用没有申请对应功能的白名单
21004营销算价结果信息不一致请求参数中各个纬度的营销算价结果不一致,请检查请求参数
21006未找到回调设置一般是没有设置对应的回调地址
21007无法查到商品关键信息下单的商品在商品库里查不到,请检查请求参数
21012创建订单失败,请稍后重试内部系统错误,请重试一下
21013开发者拒绝交易一般是开发者拒绝了下单请求
21015开发者返回的参数非法开发者预下单回调返回的参数非法,请检查请求参数
21016外部单号已存在开发者传入的外部单号重复,请检查请求参数
21017外部单号格式不正确开发者传入的外部单号格式非法,请检查请求参数
21018非法的核销poi_id开发者核销的时候传入的poi_id非法,请检查请求参数
21019商品价格有变动商品价格有变更,需要重新下单
21020商品不支持一次购买多份当前商品限购1份
21021用户购买超出限制一般是商品有限购,用户累计购买的数量过多
21022单次购买超出上限一般是商品有限购,用户单次购买的数量过多
21023商品已过期商品信息已过期,请检查商品信息
21024商品已下线商品下线,请检查商品信息
21025商品已售罄商品已售罄,请检查商品信息
21026下单次数超限制下单商品的总次数超出限制
21030订单状态不支持关单订单已支付,无法关闭订单
21032开发者商品id重复请求里有重复的商品id,请检查请求参数
21042商品状态无效商品状态错误,请检查商品信息
21043商品库存不足商品库存错误,请检查商品信息
21045订单已超时,无法继续支付订单已经过了支付有效期,无法继续支付
21046订单收款商户号不合法订单的收款商户没有加入白名单
21047商品单id不合法商品单id为空,或不是抖音的商品单id,请检查请求参数
21048下单失败,不允许非商品库商品下单该应用不支持非商品库商品下单,有需要的话,请申请白名单
21110生成核销码失败
21111订单不运营推送核销状态,请使用抖音码(闭环核销)方案核销
21112此外部订单不是交易系统订单
21113三方码参数校验未通过
21114当前订单非抖音码订单,无法使用核销组件展示
21116预约商品不允许推送 核销状态
21117加价单不允许推送核销状态
22000订单不允许退款
22001订单item子单不允许退款
22002没有可以退款的item订单
22004外部退款单号重复了开发者生成的外部退款单号以前已经用过了,请重新生成
22005因cps限制订单不允许退款cps有订单对退款有一些程序处理过程中的限制
22006退款审核状态前置步骤未完成
22007超出单次最大可退款的商品数量一般是单次退款item订单的数量超过了100
22008超出可退款的商品数量用户可以发起退款的订单数小于请求数
22009发起退款的订单同时存在分账前和分账后状态
23001分账参数错误
23101订单不存在,无法分账
23102订单未支付,无法分账
23103小程序在禁止分账名单中,无法分账
23104服务商在禁止分账名单中,无法分账
23105支付后不满N天,无法分账
23106核销后不满N天,无法分账
23107订单未完成,无法分账
23108单笔订单分账次数过多
23109分账金额超过授权比例
23110服务商无对应小程序分账授权
23111out_settle_no已存在,请用查询接口查询分账结果
23112订单已无可分账金额
23113该订单不允许分账
23114消息版本号<已存在的版本号, 跳过本次更新
23115新poi未关联商户号
23116开发者未认领poi
23117该订单属于自动结算订单, 无需请求分账
23118不允许发起整单结算
23119不允许发起券结算
23120券未核销,无法分账
23121券结算功能灰度中,请联系运营开通
24000扩展点服务配置不存在,请配置对应的扩展点没有配置扩展点的回调地址,请参考 行业模版使用指南
24001调用扩展点出错调用扩展点,请参考具体的提示,一般是开发者的服务有问题,导致调用失败
25000活动信息无效
25001活动已结束
25002活动未开始
25003商品总价太低,无法使用优惠
25004当前商品无法使用优惠
25005用户不满足活动条件
26001当前订单状态不可支付一般是订单已经过期了或者是已经支付了
26002订单支付 token 无效
26003小程序违规,支付能力被封禁
26004商家账户升级中,请稍后一般晚一点重试一下就好了
上一页
退款结果通知
下一页
通用参数
Built with