聚水潭的API接口如何申请？聚水潭开放平台API对接指南【开发者】

有志者，事竟成！如果你在学习文章，那么本文《聚水潭的API接口如何申请？聚水潭开放平台API对接指南【开发者】》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

需先完成开发者入驻与应用创建流程：一、注册聚水潭开放平台并实名认证；二、创建自有商城应用获取app_key/app_secret并申请API权限；三、在ERP后台新增店铺并绑定至应用；四、配置消息推送地址及验签逻辑；五、通过授权接口获取并自动刷新access_token。

如果您希望在自有系统中调用聚水潭的API接口，但尚未获得合法调用权限，则需先完成开发者入驻与应用创建流程。以下是申请聚水潭API接口的具体步骤：

一、注册并入驻聚水潭开放平台

入驻是获取API调用资格的前提，必须通过聚水潭开放平台完成实名认证与开发者身份审核。只有审核通过的账号才能创建应用、申请接口权限。

1、访问聚水潭开放平台官网：https://openweb.jushuitan.com。

2、点击右上角“注册”按钮，使用企业邮箱完成账号注册。

3、登录后进入“我的中心”→“开发者入驻”，填写企业营业执照、法人信息、联系人等资料。

4、提交后等待平台人工审核，通常为1–3个工作日；审核通过后将收到站内信及邮件通知。

二、创建自有商城应用并获取凭证

每个调用聚水潭API的业务系统需独立注册为一个应用，系统将为此应用分配唯一的身份标识，用于后续签名认证与权限控制。

1、审核通过后，进入“应用管理”→“创建应用”，选择应用类型为自有商城。

2、填写应用名称、描述、回调域名（需与后续消息推送地址一致）、授权回调地址（如：https://yourdomain.com/jst/callback）。

3、提交创建后，系统自动生成app_key与app_secret，请立即复制并安全保存，该密钥不可再次查看。

4、在应用详情页中，点击“API权限管理”，勾选所需接口（例如：订单同步、库存查询、物流回传等），提交权限申请。

三、配置店铺并绑定应用

API调用需关联具体业务实体——即聚水潭ERP后台中的店铺，否则无法执行订单、库存等操作。绑定关系决定了数据隔离与作用域范围。

1、登录聚水潭ERP正式后台：https://www.erp321.com。

2、进入“基础设置”→“店铺管理”→“新增店铺”，平台类型选择自有商城。

3、填写店铺名称，保存后系统生成唯一店铺编号（shop_no）；若未显示该字段，请点击列表右上角“列设置”，勾选“店铺编号”。

4、返回开放平台，在对应应用的“店铺绑定”页面，输入该店铺编号并提交绑定。

四、配置消息推送与回调验证

对于订单创建、库存变更、售后申请等实时事件，聚水潭通过HTTP POST方式向开发者服务器推送消息；回调地址必须可公网访问且能正确响应验签逻辑。

1、在开放平台“消息管理”→“订阅管理”中，选择已绑定的店铺，订阅所需消息类型（如：trade_create、inventory_update、aftersale_apply）。

2、在“消息推送配置”中，填写消息推送地址（callback_url），该地址需支持HTTPS协议且响应时间≤3秒。

3、服务端需按聚水潭规范实现签名验证：使用app_secret对timestamp+body进行HMAC-SHA256签名，并比对请求头中X-Jushuitan-Signature字段值。

4、首次配置后，平台将发送测试消息，需返回HTTP 200及JSON格式{"code":0,"msg":"success"}，否则推送将被暂停。

五、获取并刷新access_token

access_token是调用绝大多数业务API的必传凭证，具有时效性（默认2小时），需在服务端缓存并自动续期，避免因过期导致接口调用失败。

1、使用app_key、app_secret、grant_type=authorization_code（首次授权）或refresh_token（续期）向授权接口发起POST请求。

2、正式环境授权接口地址为：https://openapi.jushuitan.com/openWeb/auth/token；测试环境为：https://dev-api.jushuitan.com/openWebIsv/auth/token。

3、成功响应包含access_token、expires_in（单位秒）、refresh_token；建议将access_token存入Redis等缓存组件，并在到期前10分钟触发刷新。

4、调用业务API时，在Header中添加：Authorization: Bearer {access_token}。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《聚水潭的API接口如何申请？聚水潭开放平台API对接指南【开发者】》文章吧，也可关注golang学习网公众号了解相关技术文章。