网关对接说明

本文档说明 RTick 站点（本平台）与 RTick 行情网关之间的对接策略。当前阶段（M0+M2+M5）尚未接入鉴权与用户系统，下述为后续阶段（M1+M3+M4）的对接规划。

密钥同步策略

RTick Gateway 当前 auth.client-tokens 为白名单。v1 对接策略：

• 平台每次 Key 变更后，admin 在「密钥同步」页执行同步动作：向 RTICK_GATEWAY_SYNC_URL（可空）推送启用 Key 全量集（POST /admin/tokens/sync，需网关后续提供 admin 端点）。
• 若网关同步 URL 未配置，则导出 api-keys.json（文档化格式），供网关侧以环境变量 / 文件加载。
• 限频 / 并发额度随套餐写入 Key 元数据，平台 Key 即为网关 Token，实现同一把 Key 两处生效。

鉴权统一

通道	传输	说明
HTTP	Header apiKey: <token>	网关校验 sha256(secret)
WebSocket	Query ?apiKey=<token>	握手期校验，失败下发 code=401 后关闭

限频与并发

• HTTP：默认单 apiKey 10 次/秒，超限 429。
• WebSocket：单 apiKey 默认最大 5 条并发长连接，随套餐扩容。
• 单次订阅 / 退订最多 200 只产品，超出分批次增量订阅。

示例主机

文档示例统一使用演示主机 https://api.rtick.io（对应环境变量 NEXT_PUBLIC_GATEWAY_HOST）。网关未上线前为演示地址，接入真实网关后由站点配置覆盖。

部署形态

• Web + API + 用户态：next start（standalone）。
• 支付确认 Worker（后续阶段）：独立进程 pnpm worker，或单副本内嵌（PAYMENT_WORKER_INLINE=true）。
• SQLite 文件挂持久卷。