|
@@ -50,7 +50,7 @@
|
|
|
|
|
|
|
|
本文档为3TMS/CTMS第三方开放接口文档，操作流程为：
|
|
本文档为3TMS/CTMS第三方开放接口文档，操作流程为：
|
|
|
1. 注册并开通TMS账号（正式环境账号联系实施，应该已经开通过了）；
|
|
1. 注册并开通TMS账号（正式环境账号联系实施，应该已经开通过了）；
|
|
|
-2. 获取接口访问令牌（token令牌只需获取一次即可，**有效期为一年！**）；
|
|
|
|
|
|
|
+2. 获取接口访问令牌（访问令牌只需获取一次即可，重复获取不会刷新令牌和有效期，**有效期为一年！**）；
|
|
|
3. 调用TMS提供的接口（需要先获取令牌（access_token））；
|
|
3. 调用TMS提供的接口（需要先获取令牌（access_token））；
|
|
|
4. 所有接口需要使用主账号调用，类似创建订单之类的接口需要使用主账号调用以后系统中才能看到！<br/>
|
|
4. 所有接口需要使用主账号调用，类似创建订单之类的接口需要使用主账号调用以后系统中才能看到！<br/>
|
|
|
**请使用主账号获取对应的token再调用其他接口!!!**
|
|
**请使用主账号获取对应的token再调用其他接口!!!**
|
|
@@ -90,7 +90,7 @@
|
|
|
|
|
|
|
|
## 获取登陆凭证接口
|
|
## 获取登陆凭证接口
|
|
|
|
|
|
|
|
-**简要描述：** 获取登陆凭证
|
|
|
|
|
|
|
+**简要描述：** 获取登陆凭证，重复获取不会刷新token和有效期，如需更新token，请使用[更新登陆凭证接口](#更新登陆凭证接口)
|
|
|
|
|
|
|
|
**请求 URL：** `/user/generate_access_token/v2`
|
|
**请求 URL：** `/user/generate_access_token/v2`
|
|
|
|
|
|
|
@@ -114,7 +114,9 @@
|
|
|
"code": 200,
|
|
"code": 200,
|
|
|
"message": null,
|
|
"message": null,
|
|
|
"data": {
|
|
"data": {
|
|
|
|
|
+ //访问令牌，有效期一年
|
|
|
"accessToken": "9d0dfe02-2349-421c-90ec-4b9ea174701b",
|
|
"accessToken": "9d0dfe02-2349-421c-90ec-4b9ea174701b",
|
|
|
|
|
+ //刷新凭证，有效期一年
|
|
|
"refreshToken": "9f8326bc-c29f-4a28-a512-26caa1a9850a"
|
|
"refreshToken": "9f8326bc-c29f-4a28-a512-26caa1a9850a"
|
|
|
}
|
|
}
|
|
|
}
|
|
}
|
|
@@ -131,7 +133,7 @@
|
|
|
|
|
|
|
|
## 更新登陆凭证接口
|
|
## 更新登陆凭证接口
|
|
|
|
|
|
|
|
-**简要描述：** 更新登陆凭证
|
|
|
|
|
|
|
+**简要描述：** 刷新访问令牌，刷新后原访问令牌(accessToken)会失效，并且有效期会重新开始计算(一年有效期)
|
|
|
|
|
|
|
|
**请求 URL：** `/user/refresh_access_token/v2`
|
|
**请求 URL：** `/user/refresh_access_token/v2`
|
|
|
|
|
|
|
@@ -144,7 +146,7 @@
|
|
|
| 参数名 | 必选 | 类型 | 说明 |
|
|
| 参数名 | 必选 | 类型 | 说明 |
|
|
|
|:----:|:---:|:-----:|:-----:|
|
|
|:----:|:---:|:-----:|:-----:|
|
|
|
| `userName` | 是 | `String` | `账号` |
|
|
| `userName` | 是 | `String` | `账号` |
|
|
|
-| `refreshToken` | 是 | `String` | `刷新凭证` |
|
|
|
|
|
|
|
+| `refreshToken` | 是 | `String` | `刷新凭证，通过登陆凭证接口获取` |
|
|
|
|
|
|
|
|
**返回示例**
|
|
**返回示例**
|
|
|
|
|
|
gmw