API

接口

一套 HTTP 接口，三个端点。凭 API key 调用，返回的是 JSON。

拿 key

目前 key 由我们人工签发 —— 自助签发还没做。注册账号之后写信到 leon@frontwise.ai，说明用途和需要的主题，我们给你开一把，并告诉你它绑定的 tenant 和权限范围。

三个端点

`GET /v1/whoami`

这把 key 是谁、能读哪些 consumer、什么时候过期，以及服务端正在跑的构建版本。先调它确认接通。

`POST /v1/digest_since`

拿「上次之后的新内容」。返回一张回执和按主题分组的投递。带上 ack 表示上一批确认收到，位置就往前推。

`POST /v1/get_batch`

凭回执重新取同一批 —— 内容是冻结的，重取几次都一样。用来做重试和分页，不会因为期间来了新消息而错位。

一次调用长什么样

curl -sS https://${YOUR_HOST}/v1/digest_since \
  -H "authorization: Bearer ${KOEGEN_API_KEY}" \
  -H "content-type: application/json" \
  -d '{"consumer_id":"your-team/main","requestId":"2026-09-14T00:00:00Z#1"}'

requestId 是你自己给这次请求起的名字。同一个 requestId 重发会拿回同一张回执，而不是又切一批新的 —— 网络重试因此是安全的。

MCP

让 AI 助手直接读 Koegen 的 MCP server 规划中，还没有开放。设计上它是这套 HTTP 接口之上的一层薄适配，所以上面三个端点就是它未来的全部能力 —— 现在先用 HTTP。