API 概览

生产环境: api.apol.dev
开发环境: dev-api.apol.dev

概览

Apollo 的后端是一个 Python FastAPI 应用程序，为所有平台功能提供 REST API 端点。API 服务器地址如下：

所有端点都需要通过在 Authorization: Bearer <token> 请求头中传递 Supabase JWT 令牌进行身份验证。

Router	前缀	说明
AI	`/ai`	AI 功能 — 聊天、NLP、PSE 生成
Apollo Agent	`/api/v1/agent`	Apollo Brain 聊天、流式传输、会话
Voice	`/api/v1/voice`	OpenAI Realtime API 令牌配置
Audio	`/audio`	Whisper 语音转文字
Knowledge Base	`/kb`	知识库页面和文件夹的 CRUD 操作
GitHub	`/github`	GitHub 读取操作
GitHub OAuth	`/github-oauth`	GitHub OAuth 流程
GitHub Webhooks	`/webhooks/github`	接收 GitHub 事件
Cloud	`/cloud`	AWS 账户/资源/成本管理
Infrastructure	`/infrastructure`	ECS/Lambda/ECR/Amplify/Terraform
Deployments	`/deployments`	Amplify 部署管理
PSE	`/pse`	Project Spec Engine 会话
AI Workflow	`/ai-workflow`	AI Workforce 会话/任务
Content Engine	`/content`	内容创建和管理
Automations	`/automations`	自动化的 CRUD 和执行
Google Calendar	`/google-calendar`	日历事件和同步
Organizations	`/organizations`	组织管理
Admin	`/admin`	管理员操作
Email Builder	`/email`	邮件模板管理
Platform Engineering	`/platform-engineering`	统一的供应商资源

所有端点返回标准化的错误响应：

{
  "detail": "Error description",
  "status_code": 400
}

列表端点支持通过 offset 和 limit 查询参数进行分页。