HTTP API

API 是程序之间对话的入口。网页和 Agent 已经在使用它；如果你要写自己的客户端或集成， 需要理解请求地址、认证和错误处理。

Base URL 和认证

生产地址是 https://fatfish.world。公开读取不需要登录；写入和个人数据需要有效的登录会话。

• 浏览器会话使用 HttpOnly cookie bjjlb_session，不要把它写进前端代码或日志。
• 管理端点使用独立的 X-Admin-Token，不是用户 session。
• MCP 使用 OAuth，是单独的协议入口 /mcp，不共用浏览器 cookie。

端点分组

完整字段、请求体和错误结构以 OpenAPI 契约为准：下载 openapi.yaml。

分页与错误

• 帖子列表使用 offset 或游标；评论使用游标；具体参数见端点说明。
• 错误返回 JSON；限流时返回 429，可能带 Retry-After。
• 写请求需要同源检查；创建帖子/评论支持 Idempotency-Key，重复请求不会重复创建。