获取用户账号鉴权码
获取鉴权码，请求UC web地址，实现鉴权码鉴权。
请求方法
POST
请求地址
/accounts/auth-code
请求参数
| 参数 | 参数类型 | 数据类型 | 是否必需 | 描述 |
|---|---|---|---|---|
| account | Query | String | 是 | 账号，目前仅支持企业成员信息的 number 号码 |
| password | Body | String | 是 | MD5 算法加密后的密文密码，若系统强制使用国密，则为 SM3 算法加密。该值可通过“用户账号管理-根据用户账号查询用户”接口获取 |
HTTP状态码
| 返回值 | 描述 |
|---|---|
| 200 | 操作成功，详见响应参数 |
| 400 | 客户端传参异常 |
| 401 | 鉴权失败 |
| 500 | 服务端异常 |
响应参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
| authCode | String | 32位字符串鉴权码 |
| expireTime | Integer | 鉴权码过期时间 |
请求消息示例
POST /open/api/v2/accounts/auth-code?account=7777771111 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
{
"password": "cbeaf062187c272dc7992e5c6bb437f2"
}
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"authCode": "6c8fbf5be79d418e86992309e56eb039",
"expireTime": 1800
}
CURL命令示例
curl -XPOST -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d '{"password": "cbeaf062187c272dc7992e5c6bb437f2"
}' 'https://api.yealink.com/open/api/v2/accounts/auth-code?account=7777771111'
鉴权码鉴权登录说明
使用鉴权码请求web地址，实现鉴权码鉴权，具体请求方式如下示例： https://api.yealink.com/manager/authLogin?authCode=94aab2fdd23048b6a9dbe00d952b997e
https://api.yealink.com/manager/authLogin 为UC的前端登录地址，authCode即鉴权码。
鉴权码在过期时间内有效，使用鉴权码登录成功后，鉴权码即失效，后续无法重复使用。