经营能力当前状态查询
接口说明
由于经营关系的变更十分频繁,且许多场景下都没有经过开发者感知。为了方便开发者更好的确认当前某个用户的当前授权状态,可以调用此接口查询经营关系。如果希望降低查询频率,可以尝试接入contract_authorize与contract_unauthorize 的 Webhook 事件
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/oauth/business_scopes/ |
HTTP Method | POST |
Scope | ma.business_token |
请求示例
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 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 28001007 | 参数不合法 | 重新检查入参,确认 OpenID 与应用对应 |
200 | 29002002 | ClientKey不合法 | 检查 Client Key 字段入参,确认应用当前状态正常 |