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