获取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失效或者不可用。 |