获取access_token(身份认证场景)
企业应用开发的过程中,如果要调用服务端API,例如:通讯录相关的接口,需要按照下面方式获取access_token。为了能在有效期内多次调用API服务,业务后台需要妥善缓存好access_token。只有在access_token过期后,才需要重新获取。
请求格式说明
请求方式: POST (HTTPS)
请求地址: https://open.welink.huaweicloud.com/api/auth/v1/tickets
请求头部:
Content-Type: application/json
请求参数:
{
"type": "u",
"client_id": "20181205191324225",
"client_secret": "abd92947-9c0d-48c6-90af-2f1aef943c1s",
"code": "123wer",
"state": ""
}
请求参数说明:
参数 | 参数类型 | 必须 | 说明 |
---|---|---|---|
client_id | String | 是 | client_id即app_id,可在We码开放平台中查看。 |
client_secret | String | 是 | client_secret 即 app_secret,可在We码开放平台中查看。 |
type | string | 是 | e 表示后台系统集成类型认证;u 表示用户身份类型认证。 |
code | String | 是 | 免登授权码,参考免登获取。 |
state | String | 否 | 非必填,状态标识,可设置为state=1。 |
请求示例:
curl -X POST \
https://open.welink.huaweicloud.com/api/auth/v1/tickets \
-H 'Content-Type: application/json' \
-d '{
"client_id": "20181217110843306",
"client_secret": "f6ef675f-bde8-415f-95f7-4a84efab8898",
"type": "u",
"code": "123wer"
}'
响应格式说明
返回结果:
{
"code": "0",
"message": "ok",
"access_token": "5e2584ad-c6ca-4cf9-8513-8216e4759911",
"expires_in": 7200
}
返回参数说明:
参数 | 说明 |
---|---|
access_token | 认证后可信任的Token凭证。 |
expires_in | Token超时时间。access_token过期后,需要重新使用client_id和client_secret获取。 |
code | 数据正常返回“0”,如果发生错误,会返回对应的错误码。 |
message | 返回信息,包括接口请求发生错误时的详细信息。 |
错误码说明:
错误码 | 说明 |
---|---|
41500 | 获取access_token异常。 |
41501 | code异常,确保code是否完整。 |
41502 | 获取access_token异常。 |
41503 | code过期,不能重复使用。 |
41504 | code只能使用一次,不能重复使用。 |
41505 | type需要设置e或者u,请根据你的场景设置对应类型。 |
411000 | 检查post数据请求方式是否为json格式,或者type错误。 |
411007 | 1、检查client_id不存在或配置错误。 2、client_secret配置错误。 |
1000 | access_token失效或者不可用。 |