# 开发必读

版本号: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或者密钥不正确"}
上次更新: 2024/4/15 下午3:32:34