获取预授权码

收藏
我的收藏
推荐使用直接获取授权链接生成授权页面,接入使用更便利。

接口介绍

该接口用于获取预授权码。预授权码 pre_auth_code 用于商家小程序授权时的安全验证。
注意:
    仅授权类型的 pre_auth_code 有效期为 10 分钟,代创建类型的 pre_auth_code 有效期为 24 小时。
    代创建类型的预授权码和授权链接每天一共只能获取50个。

请求

基本信息

查询参数

参数名
参数类型
是否必须
备注
component_appid
string
第三方小程序应用 appid
component_access_token
string
第三方小程序应用接口调用凭据

请求体(json)

参数名
参数类型
是否必须
备注
pre_auth_code_type
number
预授权码类型,不传默认为1
1: 仅授权;
2: 代创建+授权
app_name
string
代创建的小程序名称,当预授权码为2时必填
会占用该小程序名称24小时,若超时未授权则会自动释放
app_icon
string
代创建的小程序图标
需要使用第三方小程序应用上传资源接口返回的路径才可以,接口调用时入参 material_type 字段为 2,否则报错。

请求体示例

{ "pre_auth_code_type": 2, "app_name": "xxx", "app_icon": "xxxxx" }

响应

响应体

参数名
参数类型
备注
pre_auth_code
string
预授权码
expires_in
int
预授权码有效期,单位:秒

响应体示例

正常示例

{ "pre_auth_code": "f0o-nCazv2IndfX6f8cXO3ZEzdYyKYEu2RQa74bsAKFB7ZdYp2Lz97GaAC2rYpcW", "expires_in": 600 }

异常示例

{ "errno": 40001, "message": "参数错误" }

错误码

错误码
message
40001
参数错误
40003
找不到相关第三方小程序应用
40009
第三方小程序应用 component_access_token 已过期
40010
第三方小程序应用 component_access_token 不正确
40045
生成 token 失败,请重试