Skip to main content

Gateway — 统一入口与鉴权

统一 API 平台入口（2026-09-20 上线）。所有对外能力收口到 https://api.eurybia.xyz。

拓扑​

partner / 外部用户
        │  X-API-Key
        ▼
  eurybia-gateway :8010（仅内网，nginx 反代 api.eurybia.xyz）
        ├─ /v1/data/*   → data-api  :8011
        ├─ /v1/ask/*    → ask-api   :8012
        ├─ /v1/quant/*  → quant-api :1230（回测转 main-db :1251）
        └─ /v1/keys/*   → 网关自实现（eurybia_meta 库）

网关承担四件事：鉴权（sha256 key 校验 + 前缀授权）、限流（每分钟 rate_limit_rpm + 可选日配额 daily_quota）、审计（全部请求落 api_audit_log）、目录（/v1/catalog 自助发现）。

Base URL 与鉴权头​

Base URL : https://api.eurybia.xyz
Header   : X-API-Key: <your_key>

鉴权顺序：401（缺失/无效 key）→ 403（key 无该路径权限）→ 429（每分钟限流）→ 429（日配额超限）。

Key 自服务​

端点说明
POST /v1/keys/request自助申请 key（body 按平台要求）
POST /v1/keys/query查询 key 状态
POST /v1/keys/rotate轮换：生成新 secret 立即生效（旧 secret 作废，新 secret 仅此一次展示）
POST /v1/keys/revoke吊销：key 立即失效

自服务端点用自己的 key 认证（rotate / revoke 用旧 key 请求）。

目录（自助发现）​

curl https://api.eurybia.xyz/v1/catalog -H "X-API-Key: sk_..."

返回全部 domain（data/ask/quant/keys/frontend）、路由清单、鉴权与限流说明。partner 接入前先打目录确认自己 key 能访问哪些路径。

限流与配额​

机制触发响应
每分钟限流超过该 key 的 rate_limit_rpm429 rate limit exceeded（带 Retry-After）
日配额（可选）超过该 key 的 daily_quota429 daily quota exceeded（次日 0 点重置）

所有请求（含拒绝的）都落审计日志，key 维度可查用量。

错误码对照​

状态码含义处理
401 missing or invalid api keykey 无效或没带检查 X-API-Key 头
403 api key is not permitted to access this pathkey 无该路径权限联系开通
429 rate limit exceeded每分钟限流降速重试或提额
429 daily quota exceeded日配额超限次日重试或提额
403 ... requires subscription成果产品未订阅联系订阅

参考​