需先完成开发者入驻与应用创建流程：一、注册聚水潭开放平台并实名认证；二、创建自有商城应用获取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}。
