获取预授权码V2
收藏接口说明
该接口用于获取预授权码。预授权码 pre_auth_code 用于商家小程序授权时的安全验证。
注意：
- 仅授权类型的 pre_auth_code 有效期为 10 分钟，代创建类型的 pre_auth_code 有效期为 24 小时。
使用限制
- 代创建类型的预授权码和授权链接每天一共只能获取50个。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/tpapp/v3/auth/get_pre_auth_code/ |
| HTTP Method | POST |
| Scope | thirdparty.dev.auth |
| 权限要求 | 无 |
请求参数
请求头
access-token必填String
示例：clt.05efxxxxxxxxxqPf9pWBo0IKVHmSKce5EvKX
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
app_iconString
代创建的小程序图标
app_nameString
示例：抖音小程序
代创建的小程序名称，当预授权码为2时必填
会占用该小程序名称24小时，若超时未授权则会自动释放
pre_auth_code_typeEnum
示例：1
授权码类型，默认为仅授权
展开子属性
请求示例
curl --location 'https://open.douyin.com/api/tpapp/v3/auth/get_pre_auth_code' \ --header 'access-token: clt.146d01xxxxxxxxxxxxxx5cvEEgN6qr8RHBRA' \ --header 'Content-Type: application/json' \ --data '{ "pre_auth_code_type": 2, "app_name": "xxx", "app_icon": "xxxxx" } '
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
示例：0
错误码
log_id必填String
示例：202401121732013479EBEFB9EAD932F53B
标识请求的唯一id
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "expires_in": 600, "pre_auth_code": "xxxxxxx" }, "err_msg": "", "err_no": 0, "log_id": "202401121732013479EBEFB9EAD932F53B" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40000 | 系统错误 | |
| 200 | 40001 | 参数错误 | |
| 200 | 40059 | 代创建小程序名称不允许为空 |
