# **获取access** 
**获取access_token**
此接口用于We码小程序(或者H5轻应用)与WeLink服务端API后台集成，实现免登, 通讯录查询等接口。
进入开放平台开发者后台,打开具体的应用，在应用的"基本信息"中获取相应的client_id和client_secret获取应用id和应用密钥。
![](https://support.huaweicloud.com/devg-welink/figure/zh-cn_image_0000001347240442.png "点击放大")
#### **请求格式说明**
**调试工具：** [在线调试](https://open.welink.huaweicloud.com/apiexplorer/#/apiexplorer?type=internal&&&method=POST&path=/auth/v2/tickets)
**请求方式：** 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失效或者不可用。                |