直接获取授权链接V2
收藏接口说明
该接口用于直接获取授权链接。服务商可以在自己的管理网站上展示此链接，并引导商家点击链接跳转到授权页面，商家确认第三方小程序应用信息，选择要授权的小程序，勾选授权权限集，点击确定即可完成授权。
注意：
- 此方式获取的授权链接有效期为 24 小时，授权成功后链接自动失效。
- 代创建类型的预授权码和授权链接每天一共只能获取50个。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/tpapp/v3/auth/gen_link/ |
| HTTP Method | POST |
| Scope | thirdparty.dev.auth |
| 权限要求 | 无 |
请求参数
请求头
access-token必填String
示例：clt.05efxxxxxxxxxqPf9pWBo0IKVHmSKce5EvKX
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
link_type必填Enum
示例：1
授权链接类型，不传默认为1
展开子属性
app_iconString
代创建的小程序图标
需要使用第三方小程序应用上传资源V2接口返回的路径才可以，接口调用时入参 material_type 字段为 2，否则报错。
app_nameString
示例：抖音小程序
代创建的小程序名称，当授权链接类型为2时必填
会占用该小程序名称24小时，若超时未授权则会自动释放
redirect_uriString
授权回调地址
授权成功后会跳转到该地址并给出授权码，详见获取授权码，不传则不跳转
该地址的域名需要和第三方小程序应用配置的【授权域名】保持一致
请求示例
curl --location 'https://open.douyin.com/api/tpapp/v3/auth/gen_link' \ --header 'access-token: clt.5980c812xxxxxxxxOdbUj622imolc2j0' \ --header 'Content-Type: application/json' \ --data '{ "link_type": 1 }'
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
示例：0
错误码
log_id必填String
示例：202401121734538F484F2C844C5C32253C
标识请求的唯一id
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0, "log_id": "202401121734538F484F2C844C5C32253C", "data": { "link": "xxxxxxxxxxx" } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | |
| 200 | 40059 | 代创建小程序名称不允许为空 |
