本来只打算花十分钟看看，结果因为下面这个问题多折腾了半小时。

分页 `GET /v1/events?limit=100` 返回 100 条，`next_cursor` 却为 null，我以为到底了；后来发现总量有 3000 多条，只是服务端在 limit 大于 50 时干脆不返回游标。

让 `GET /v1/events` 在 `limit` 很大时也返回 `next_cursor` 和 `total`；我预期能安全做全量同步，不用改成 50 条一轮慢慢拉。

免费额度和速率限制挤在同一组响应头里，容量估算经常差一个数量级。

我当时的调用大概是这样：

try {
  const r = await client.chat.completions.create(req);
  return r.choices[0];
} catch (err) {
  const e = err as { status?: number; request_id?: string; message: string };
  logger.error("beehub call failed", {
    status: e.status,
    requestId: e.request_id ?? "missing",
    message: e.message,
  });
  throw err;
}