# 开发必读
版本号:V1.0
# 环境变量
## 测试环境
{BASE_URL}: https://*****/ws-test/rute
{JWT_URL}: https://*****/ws-test/auth/openapi
## 生产环境:
{BASE_URL}: https://*****/openapi
{JWT_URL}: https://*****/jwt/auth/openapi
> **域名的具体地址请向客服人员申请
# 安全认证
appKey 公司独立 key ******* appSecret 密钥 *******
获取全局access_token(重要)
access_token是开放平台的全局唯一接口调用凭据,调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的access_token失效。
建议开发者使用定时任务统一获取和刷新access_token并存入redis,其他业务逻辑服务器所使用的access_token均来自于该redis,不应该各自去刷新,否则容易造成冲突,导致access_token覆盖而影响业务;
GET https://{JWT_URL}?appid={appKey}&secret={appSecret}
正常情况下,平台会返回下述JSON数据:
{
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI1ZTdkYzQ3YWU4ZTBhIiwiaWF0IjoxNTg1MzAwNjAyLCJuYmYiOjE1ODUzMDA2MDIsImV4cCI6MTU4NTMwNzgwMiwiaWQiOjEwMjAwNTg4MjI0MTQyOTUwNCwiaXNzIjoib29ob2lqdVNoM0llZmFpM2llcHU5b2hzYWVGNXV6MGUifQ.5gT5WGAS5VCpDwi_1q90hYve5kWzHomJHV6Pxv-MiGg",
"expires_in": 7200
}
如果出错,服务端会返回400的HTTP错误码
HTTP/1.1 400 Bad Request
Date: Fri, 27 Mar 2020 09:30:08 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 43
Connection: close
{"code":1022,"message":"应用id或者密钥不正确"}