• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 联合授权
  • 视频能力
  • 线索组件
  • 接口调用凭证
  • 经营能力调用凭证
  • BusinessToken 生成
  • BusinessToken 刷新
  • 经营能力当前状态查询
  • 非用户授权调用凭证
  • 用户授权调用凭证
  • 登录
  • Web 化接入
  • 隐私协议
  • 流量主
  • 小程序码与小程序链接
  • 用户信息
  • 抖音号绑定
  • 小程序推广计划
  • 内容安全
  • 任务能力
  • 分享
  • 客服
  • 小程序券
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 接口说明

    由于经营关系的变更十分频繁,且许多场景下都没有经过开发者感知。为了方便开发者更好的确认当前某个用户的当前授权状态,可以调用此接口查询经营关系。如果希望降低查询频率,可以尝试接入contract_authorize与contract_unauthorize 的 Webhook 事件

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/oauth/business_scopes/
    HTTP Method
    POST
    Scope
    ma.business_token

    请求参数

    请求头
    access-token必填String
    调用生成的token
    content-type必填String
    示例:application/json
    固定值"application/json"
    请求示例
    curl --location 'https://open.douyin.com/oauth/business_scopes/' \ --header 'Content-Type: application/json' \ --header 'access-token: bus_act.7770b14e2ef6e5fb*********C0COqHrU26YHimdeRrId2s'

    响应参数

    Body
    dataArray<String>
    示例:["video.data.bind", "video.list.bind"]

    经营关系调用凭证

    error_codeInt64
    messageString
    响应示例
    正常响应示例异常响应示例
    { "data": [ "video.data.bind", "video.list.bind" ], "error_code": 0, "message": "" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001007
    参数不合法
    重新检查入参,确认 OpenID 与应用对应
    20029002002
    ClientKey不合法
    检查 Client Key 字段入参,确认应用当前状态正常