更新时间:2023-12-18 GMT+08:00
分享

获取access

获取access_token

此接口用于We码小程序(或者H5轻应用)与WeLink服务端API后台集成,实现免登, 通讯录查询等接口。

进入开放平台开发者后台,打开具体的应用,在应用的“基本信息”中获取相应的client_id和client_secret获取应用id和应用密钥。

请求格式说明

调试工具: 在线调试

请求方式: POST (HTTPS)

请求地址: https://open.welink.huaweicloud.com/api/auth/v2/tickets

请求头部:

Content-Type: application/json

请求参数:

{
  "client_id": "20190828163922073733756",
  "client_secret": "7c4f1e6e-f2db-42bd-a2c1-b2905c1c2a5b"
}

请求参数说明:

参数

参数类型

必须

说明

client_id

String

client_id 即 app_id,可在We码小程序开放平台中查看。

client_secret

String

client_secret 即 app_secret,可在We码小程序开放平台中查看。

请求示例:

curl -X POST

https://open.welink.huaweicloud.com/api/auth/v2/tickets

-H 'Content-Type: application/json'

-d '{

"client_id": "20190828163922073733756",

"client_secret": "7c4f1e6e-f2db-42bd-a2c1-b2905c1c2a5b",

}'

响应格式说明:

返回结果:

{

"code": "0",

"message": "ok",

"access_token": "5e2584ad-c6ca-4cf9-8513-8216e4759905",

"expires_in": 7200

}

返回参数说明:

参数

说明

access_token

认证后可信任的Token凭证。

expires_in

数值型数据,单位是秒,如:7200,代表当前access_token的有效期,该值可能会随平台调整而动态变化,不是固定不变的。

最佳实践:

1、access_token缓存时间为(xxxx-300)秒,假设当前expires_in 的返回值是1800(该值是动态变化的,可能是其他值,如1000等),缓存时间应该设置为(1800-300=1500)秒;

2、若access_token失效,清理缓存,并重新获取access_token。

code

数据正常返回“0”,如果发生错误,会返回对应的错误码。

message

返回信息,包括接口请求发生错误时的详细信息。

错误码说明:

错误码

说明

41500

获取access_token异常。

41403

通过clientId获取access_token失败次数过多,被锁定。

41579

clientId为空。

41580

clientSecret为空。

10007

clientId或clientSecret有误

411145

系统异常

1000

access_token失效或者不可用。

相关文档