邻聚云 · 连接器

连接器能力地图

由小程序与租户能力反推：商品库存、订单、发货、对账、事件五类集成点，与圈主移动端 ERP 授权（F4-10）互补。

创建应用→租户授权→API/回调→生产监控

已授权租户

—

今日回调成功

99.2%

应用数

—

月 API 调用

—

活跃 ISV

—

ISV 生态榜（演示）

应用	授权租户	月调用量

·

应用与 Key

应用名	Client ID	平台审核	操作

创建应用后向租户发起授权（OAuth 示意）；租户管理员在租户中心审批。

租户授权记录

租户	权限范围	状态	操作

商品库存同步

POST /v1/tenants/{tenant_id}/skus/sync
Authorization: Bearer <access_token>

{ "sku_code": "ORANGE-5KG", "stock": 120, "version": 42 }

需幂等与版本号；与 F1-12 锁定库存策略在服务端仲裁。

订单拉取

GET /v1/tenants/{tenant_id}/orders?status=PAID&since=...

子单粒度（F3-17）；含费率与分账快照 ID 供对账。

发货回传

POST /v1/orders/{sub_order_id}/shipments
{ "carrier": "SF", "tracking_no": "SF123..." }

回写后触发物流轨迹订阅（F4-12）。

对账单下载

账期

与租户/平台财务对账口径一致，不含货款托管字段。

事件订阅

事件	推送 URL	操作

退款与售后回传

POST /v1/orders/{sub_order_id}/refunds
{ "refund_id": "R...", "status": "SUCCESS", "amount": 2990 }

与事件 refund.success 双通道；ERP 以对账为准。

API 文档与错误码

鉴权：OAuth2 租户授权 + Bearer Token
幂等：Header Idempotency-Key
限流：按应用 QPS 配额

错误码	说明
LINJU_401	Token 无效或过期
LINJU_409	库存版本冲突
LINJU_422	分账快照不匹配

沙箱与监控

沙箱租户

时间	事件	结果

回调失败重试与签名校验文档见。

邻聚库存桥

Client IDapp_7x9k2m

Client Secretsec_••••••••rotate

回调域名

demo-retail 授权

权限范围商品读/写、订单读、发货写

授权时间2026-09-01

状态有效

租户审批入口：租户中心 · ISV 应用审批

order.paid

推送 URL

签名密钥whsec_••••

重试策略指数退避 · 最多 24h

导出任务

已生成分账明细_20261006.csv · 1,248 行

沙箱请求

接口

租户

{ "sku_code": "ORANGE-5KG", "stock": 120, "version": 42 }

响应与回调记录在。

失败回调重放

时间	事件	结果	操作
10:28:44	inventory.sync	500

轮换 Client Secret

新 Secret 立即生效；旧 Secret 24h 内仍可用于回调验签。