8030 控制台登录

按 Token 限制外放接口的调用速度，超出返回 429。保存后立即生效，无需重启服务。

加载中…

快速开始

三步接入：①在「外放 API」页生成 Token 并写入服务端环境变量 ODDS_BET_ALERT_TOKEN；②按下面的示例带上 Token 发起请求；③按「调用限速」一节控制请求频率。接口均为只读 GET，返回 application/json; charset=utf-8（SSE 为 text/event-stream）。

curl -s -H "Authorization: Bearer {{TOKEN}}" \
  "{{BASE}}/api/external/bet-alerts?since=0&limit=50"

鉴权

所有外放接口共用同一个 Token。服务端按下表顺序取值，取到第一个非空的就不再往下找。

Token 有两种形式，效果完全等价：

调用限速

按 Token 计数（不是按 IP），所有外放接口共享同一个配额桶。当前配置：每分钟 — 次，突发 — 次。可在「外放 API」页随时调整，保存即生效。

超出配额返回 429，带 Retry-After: 60 响应头，响应体：

{"ok":false,"error":"rate_limited","rate_per_min":60,"burst":20}

GET新注单实时推送（SSE）

/api/external/bet-alerts/stream?token=<token>

与控制台新注单弹窗同源的实时流。Content-Type 为 text/event-stream，事件名固定为 bet_alert，data 为一条 JSON。

const es = new EventSource("{{BASE}}/api/external/bet-alerts/stream?token={{TOKEN}}");
let lastId = 0;

es.addEventListener("bet_alert", (e) => {
  const rec = JSON.parse(e.data);
  lastId = rec.alert_id;
  console.log(rec.event.wager_id, rec.event.stake, rec.event.market);
});

es.onerror = () => {
  // EventSource 会自动重连；重连成功后用 lastId 调轮询接口补齐断连期间的告警
  console.warn("SSE 断开，最后收到的 alert_id =", lastId);
};

GET新注单轮询

/api/external/bet-alerts?since=0&limit=50

SSE 的轮询替代方案，也用于断线后补齐历史告警。服务端只保留最近若干条告警，长时间不拉可能丢失，建议轮询间隔不超过一分钟。

响应为 {"ok":true,"items":[…],"next_since":N}。items[].event 的字段：

curl -s -H "Authorization: Bearer {{TOKEN}}" \
  "{{BASE}}/api/external/bet-alerts?since=0&limit=50"

错误码

运维状态，非安全事件：internal keeper 请求未携带用户 Token 的来源。归零后才可设 ODDS_INTERNAL_REQUIRE_USER_TOKEN=1。

加载中…