获取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": "",
  "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",S
    "code": ""  
  }'

响应格式说明

返回结果:

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

result. ""

    Not Found. ""