轻易云
注册体验
POSThttps://openapi.jushuitan.com/openWeb/auth/getInitTokenapp_key + app_secret 签名换 token

获取初始授权 Token(自有商城应用)

聚水潭新版开放平台授权接口:自有商城应用凭 app_key + 签名获取初始 access_token/refresh_token,到期前用 refreshToken 续期,业务接口凭 access_token + 签名调用。

## 接口说明 聚水潭新版开放平台(openweb.jushuitan.com)采用 OAuth 风格的 access_token 体系。对接单个 ERP 商家的场景创建【自有商城应用】;为多个商家提供服务的场景创建【服务商应用】(走授权链接 + code 换 token 流程)。自有商城应用审核通过后,可用 getInitToken 直接换取初始 access_token 与 refresh_token;access_token 到期前调用 refreshToken 接口续期。 ### 签名规则 1. 将除 sign 外的所有请求参数按参数名 ASCII 升序排序。 2. 按 key + value 顺序拼接成字符串(不加分隔符、不做 URL 编码)。 3. 在拼接串首尾各拼接一次 app_secret。 4. 计算 MD5(32 位十六进制)作为 sign。 请求公共参数:app_key、timestamp(Unix 秒级时间戳,与聚水潭服务器时间差须在 10 分钟内)、charset(utf-8)、grant_type 及 sign。 ### 响应与使用 成功返回 code=0,data 中含 access_token、refresh_token、expires_in。业务接口调用时把 access_token 放入公共参数并重新计算 sign。轻易云连接器已封装 token 的获取、缓存与自动续期。 ### 错误处理 code=100 表示 access_token 超时,应立即用 refresh_token 续期或重新走授权;code=10 表示签名无效,重点核对排序与 app_secret。

代码示例

curl
curl -X POST "https://openapi.jushuitan.com/openWeb/auth/getInitToken" \
  -H "Content-Type: application/json" \
  -d '{"app_key":"your_app_key","timestamp":1780000000,"charset":"utf-8","grant_type":"init_token","sign":"SIGN"}'

错误码

错误码消息含义
0执行成功授权成功
10验证失败!无效签名签名错误,核对参数排序、拼接与 app_secret
100access_token 超时token 过期,使用 refresh_token 续期或重新授权
110验证失败授权已失效或被回收,需重新完成应用授权