API 总览
连接你的商店、货源与业务系统。
先选择接入身份，再开始调用接口。
选择你要接入的 API
SUPPLY API货源与订单对接 →
使用 API Key / Secret 查询商品、提交供货订单与接收通知。
STOREFRONT API商城与会员业务 →适用于自定义商城、商品展示、订单、支付和会员中心。
ADMIN API管理后台集成 →使用管理员身份与角色权限管理业务数据。
| API | 地址前缀 | 身份 | 本地接口参考 |
|---|---|---|---|
| 原生供货 | /api/supply/ | 四个 X-Supply-* 签名头；Ping 除外 | 10 个接口 |
| 商城前台 | /api/v1/storefront/ | 公开接口或会员 Bearer Token | 商城模块 |
| 管理后台 | /api/v1/admin/ | 管理员 Bearer Token + 权限校验；公开登录接口除外 | 管理模块 |
当前快照包含 343 个生成式接口定义：供货 10 个、商城 74 个、后台 259 个。此数字不包含手写的兼容协议、健康检查和其他自定义路由。
推荐接入顺序
- 阅读通用约定，确认请求字段、金额单位和错误处理方式。
- 在自己的测试站完成安装，准备对应身份的账号。
- 先执行只读调用：供货 Ping / 商品查询，或商城商品列表。
- 对照接口参考核对字段，再实现订单和回调。
- 检查超时、重复请求、余额不足与库存不足等情况，再开展真实业务联调。
当前文档的范围
接口参考已放在本站，字段和路由来自受控的源码快照。原生供货另有人工核对的鉴权、商品、订单和回调说明。生成式参考展示接口定义，不代表每个业务字段都已逐一完成运行时验收。
下载协议与示例
- JSON 协议快照：按当前默认 JSON 编码校对字段名、64 位数值类型及路径参数；可在本地工具导入。
- 上游原始 OpenAPI：保留源码生成结果，用于对照。它与当前默认 JSON 编码存在差异，详见通用约定。
- Node.js 签名示例：本地计算签名，默认 CLI 只读取商品列表。
本站不保存你的密钥，也不会在浏览器中发起真实采购、退款或管理操作。