## 刷新accesstoken
### 接口说明
该接口用于在accessToken即将失效时,通过该接口强制更新令牌,1分钟内只能访请求1次。
### 请求URL
{{url}}/v1/token/refresh
### HTTP请求方式
GET/POST
### 请求参数
(1)通用参数
参见:[通用参数](/2523136)
(2)私有参数
| 参数名称 | 参数类型 | 是否必填 | 参数说明 | 取值说明 | 默认值 |
| --- | --- | --- | --- | --- | --- |
| refreshToken | String | 是 |授权的刷新令牌 | | |
| expiresIn | String | 是 | accessToken的有效期,以秒为单位 | 60-7200 | |
### 返回值
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| code | Int | 返回码:0: 正确返回 其它: 失败。参考错误码说明 |
| success | Boolean | 成功:true;失败:false |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 结果 |
| timestamp | Long | 时间戳 |
#### result参数列表:
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| accessToken | String | 后续接口访问的访问令牌,对应到用户下的帐号 |
| expiresIn | String | 有效期 |
| refreshToken | String | 刷新令牌,用于更新accessToken |
| tokenCreateTime | String | 令牌生成的时间 |
| account | String | 请求的账号 |
| appKey | String | 途狐管车分给客户的appKey |
#### 正确返回示例:
~~~
{
"code": 0,
"success": true,
"message": "Success",
"result": {
"accessToken": "34d9df79c3ff4b10868fafb418929685",
"expiresIn": 200,
"refreshToken": "c1f32bf891304a5984f52643ef9c198c",
"tokenCreateTime": "2021-11-08 11:52:15",
"account": "15156981372",
"appKey": "testkey001"
},
"timestamp": 1636343537081
}
~~~
#### 错误返回示例:
~~~
{
"code": 1009,
"success": false,
"message": "refreshToken失效!",
"result": "",
"timestamp": 1636343446272
}
~~~
- 目录
- 概述
- 使用场景
- 使用方法
- 协议格式
- 公共约定
- API简介
- 通信流程
- API列表
- 接口调用限制说明
- API详情
- 认证说明
- 通用参数
- 获取accessToken
- 刷新accessToken
- 注册设备到平台
- 根据账户获取设备信息
- 根据账户获取所有设备的最新定位数据
- 根据IMEI获取最新定位数据
- 根据IMEI获取设备详细信息
- 根据IMEI获取轨迹数据
- 获取设备支持的指令列表
- 指定设备发送指令
- 获取设备指令结果
- 根据用户名获取分组列表
- 创建分组
- 修改分组信息
- 删除分组
- 根据账户获取车辆列表
- 根据分组ID获取车辆列表
- 添加车辆
- 修改车牌
- 转移车辆(改变分组)
- 获取围栏列表
- 获取围栏相关车辆
- 新增围栏
- 删除围栏
- 围栏关联车辆
- 消息推送