找回授权码V2
收藏接口说明
为了防止授权小程序刷新令牌 authorizer_refresh_token 丢失后失去小程序的操作权限，增加补偿机制。对于目前已存在授权关系的情况，服务商可以直接找回授权码 authorization_code ，然后再换取授权小程序接口调用凭据 authorizer_access_token。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/tpapp/v2/auth/retrieve_auth_code/ |
| HTTP Method | POST |
| Scope | thirdparty.dev.auth |
| 权限要求 | 无 |
请求参数
请求头
access-token必填String
示例：clt.05efxxxxxxxxxqPf9pWBo0IKVHmSKce5EvKX
content-type必填String
示例：application/json
固定值"application/json"
Body
authorization_appid必填String
授权小程序 appid
请求示例
curl --location 'https://open.douyin.com/api/tpapp/v2/auth/retrieve_auth_code' \ --header 'access-token: clt.bb9a8xxxxxxxxxxzt2DFiL49FxaW7Hg6GEj46' \ --header 'Content-Type: application/json' \ --data '{ "authorization_appid": "xxxxxxxx" }'
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
示例：0
错误码
log_id必填String
示例：20240112171812CA5FDE08E24D242EFEAD
标识请求的唯一id
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "authorization_code": "xxxxxxxxxxx", "expires_in": 3600 }, "err_msg": "", "err_no": 0, "log_id": "20240112171812CA5FDE08E24D242EFEAD" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40000 | 系统错误 | |
| 200 | 40001 | 参数错误 | |
| 200 | 40004 | 找不到相关授权小程序 | |
| 200 | 40022 | 此小程序未授权给第三方小程序应用 |
