新增抖音号绑定、能力授权_

接口说明

创建抖音号和泛知识角色之间的绑定关系
发起抖音号的自挂载、IM客服能力绑定请求

注：上述两个请求发起后都需要抖音号在抖音端内完成确认，请保证抖音版本在24.2.0以上

使用限制

前提条件

泛知识行业角色已经入驻，且抖音号合法（角色入驻指南：https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/Industry/pan-knowledge/knowledge-role）
泛知识行业角色和对抖音号做能力授权的小程序存在合作关系

基本信息

名称	描述
HTTP URL	https://developer.toutiao.com/auth/entity/enable_mountscope
HTTP Method	POST
Scope	developer.open.role.manager
权限要求	AccessToken鉴权

请求头

名称	字段类型	是否必填	示例	描述
content-type	String	是	application/json	固定值"application/json"

请求参数

Body

名称	字段类型	是否必填	描述
access_token	String	是	调用生成的token
appid	String	是	小程序appid
aweme_id	String	是	抖音号，在抖音用户个人页获取，具体位置如图所示。与c_user 必填其一，同时填入时优先取 aweme_id
industry_code	Enum	是	行业
industry_role	Enum	是	行业角色
merchant_entity_id	String	是	行业角色实体ID
c_user	Struct	否	抖音账户相关信息与aweme_id必填其一，同时填入时优先取aweme_id
mount_scope	Enum	否	挂载权限与mount_scope_list必填其一，同时传入时都会进行授权
mount_scope_list	List	否	取值同上mount_scope。需一次开通多个能力时可以通过该参数传入，同时传入mount_scope 与 mount_scope_list时，会合并进行授权
partner_entity_id	String	否	服务商实体

请求示例

{
    "appid": "tta12xxxxxcbe01",
    "access_token": "080yyyyyyy35494e62413d3d",
    "aweme_id" : "xxxxxxxxxx",
    "merchant_entity_id": "E_7178703725698269228",
    "partner_entity_id":"",
    "industry_code":10000,
    "industry_role":1,
    "mount_scope_list": [1, 2, 3, 4, 5]
    
}

响应参数

Body

名称	字段类型	是否必填	示例	描述
err	Struct	否		错误信息

响应示例

正常响应示例

{
  "err": {
    "err_code": 0,
    "err_msg": ""
  }
}

异常响应示例

暂无

错误码

http状态码	错误码	错误码描述	排查建议
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001003	access_token无效	重新请求生成access_token
200	28001008	access_token过期,请刷新或重新授权	重新请求生成access_token
200	28001016	当前应用已被封禁或下线	clientKey被封禁或者下线
200	28001006	网络调用错误，请重试	重试即可
200	28001014	应用未授权任何能力	确认应用是否授权能力
200	28001018	应用未获得该能力	开通相关能力
200	28003017	quota已用完	联系平台处理
200	28001019	应用该能力已被封禁	该能力被封禁，联系平台处理
200	28001007	参数不合法	根据错误信息检查请求参数是否填写正常

新增抖音号绑定、能力授权在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

​错误码​

新增抖音号绑定、能力授权

错误码