站点对接说明

dujiao-shop 支持两个独立站点之间互联(典型场景:总站 + 分销代理站、上游商品分发到下游),通过 site_connections 机制完成。

应用场景

• 上游分发:主站维护商品 + 卡密池,几个代理站直接拉商品列表 + 下游下单透传回主站
• 分销联盟:几家 dujiao 站点互相把对方商品挂在自己货架上
• 数据同步:多个 dujiao 实例做主备,定时同步

双方协议

后端字段 protocol:dujiao-next(默认,跨 dujiao 站点互联),后续可能扩展其他协议。

⚠️ protocol 字段值必须保留 dujiao-next 字面量(老代码常量,改了就跟其他 dujiao 站不兼容)。

配置流程

主站和代理站两边都要互相配。

主站(被对接方)

后台 → 站点对接 → 添加 → 角色选 "作为上游":

字段	说明
对接方名称	给对方一个标签,便于审计
API Key	主站自动生成,告诉对方
API Secret	主站自动生成,告诉对方(只显示一次)
回调 URL	对方告诉你的(分销订单交付时主站回调对方)
协议	dujiao-next

代理站(对接方)

后台 → 站点对接 → 添加 → 角色选 "作为下游":

字段	说明
主站 API URL	https://main.your.com
主站 API Key	主站给的
主站 API Secret	主站给的
协议	dujiao-next

数据流

下单时:

访客 → 代理站 → 创建订单 (透传商品 ID + 数量) → 主站
                            ↓
访客付款 ← 代理站(用代理站自己支付通道)
                            ↓
代理站 → 通知主站"已付款"
                            ↓
主站划库存 → 卡密 → 代理站 → 访客

代理站收取抽成,主站结算给代理。

安全

• API Key + Secret 用 HMAC-SHA256 签每个请求
• 每个请求带 nonce + timestamp 防重放,主站缓存 5 分钟内的 nonce
• Secret 只在创建时返回一次,丢了只能重新生成新的

关闭对接

后台 → 站点对接 → 选某条 → 禁用 / 删除。

禁用 = 拒绝新订单,已有订单不影响。 删除 = 完全断开,key 失效。

详细 API

见 站点对接 API 文档。