获取access_token(集成认证场景)
此接口仅限于ISV系统与WeLink服务端后台集成(不适用于We码应用场景),实现考勤数据对接、通讯录查询等数据接口认证。调用此接口需要使用当前ISV应用的应用ID(唯一)与对应的应用secret,以完成数据上传或下载等操作。
- 进入开放平台创建We码应用获取应用id和应用密钥。
- 目标租户的tenant_id来自回调接口,即租户订阅ISV应用时,会调用回调接口将租户id传给ISV应用。
请求格式说明
请求方式: POST (HTTPS)
请求地址: https://open.welink.huaweicloud.com/api/auth/v1/tickets
请求头部:
Content-Type: application/json
请求参数:
{
"client_id": "20190828163922073733756",// 应用id
"client_secret": "7c4f1e6e-f2db-42bd-a2c1-b2905c1c2a5b", // 应用secret
"type": "e",
"tenant_id": "KN0182DCSH9SJ45N90A3NNSL3AHS"// 非必填,订阅租户的租户id
}
请求参数说明:
参数 | 参数类型 | 必须 | 说明 |
---|---|---|---|
client_id | String | 是 | client_id 即 app_id,可在We码开放平台中查看。 |
client_secret | String | 是 | client_secret 即 app_secret,可在We码开放平台中查看。 |
type | string | 是 | e 表示后台系统集成类型认证,u 表示用户身份类型认证。 |
tenant_id | string | 是 | 必填,订阅租户的租户id。 |
state | String | 否 | 非必填,状态标识,可设置为state=1。 |
请求示例:
curl -X POST \
https://open.welink.huaweicloud.com/api/auth/v1/tickets \
-H 'Content-Type: application/json' \
-d '{
"client_id": "20190828163922073733756",
"client_secret": "7c4f1e6e-f2db-42bd-a2c1-b2905c1c2a5b",
"type": "e",
}'
响应格式说明
返回结果:
{
"code": "0",
"message": "ok",
"access_token": "5e2584ad-c6ca-4cf9-8513-8216e4759905",
"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失效或者不可用。 |