Übersicht
Apollos Backend ist eine Python FastAPI-Anwendung, die REST-API-Endpoints für alle Plattformfunktionen bereitstellt. Der API-Server ist erreichbar unter:- Produktion:
api.apol.dev - Entwicklung:
dev-api.apol.dev
API-Architektur
Alle Endpoints erfordern eine Authentifizierung über Supabase JWT-Tokens, die im HeaderAuthorization: Bearer <token> übergeben werden.
Router-Übersicht
| Router | Präfix | Beschreibung |
|---|---|---|
| AI | /ai | KI-Funktionen — Chat, NLP, PSE-Generierung |
| Apollo Agent | /api/v1/agent | Apollo Brain Chat, Streaming, Sitzungen |
| Voice | /api/v1/voice | Token-Bereitstellung für die OpenAI Realtime API |
| Audio | /audio | Transkription mit Whisper |
| Knowledge Base | /kb | CRUD für Wissensdatenbank-Seiten und -Ordner |
| GitHub | /github | GitHub-Leseoperationen |
| GitHub OAuth | /github-oauth | GitHub OAuth-Ablauf |
| GitHub Webhooks | /webhooks/github | Eingehende GitHub-Events |
| Cloud | /cloud | AWS-Konto-/Ressourcen-/Kostenverwaltung |
| Infrastructure | /infrastructure | ECS/Lambda/ECR/Amplify/Terraform |
| Deployments | /deployments | Amplify-Deployment-Verwaltung |
| PSE | /pse | Project Spec Engine-Sitzungen |
| AI Workflow | /ai-workflow | AI Workforce-Sitzungen/-Jobs |
| Content Engine | /content | Inhaltserstellung und -verwaltung |
| Automations | /automations | CRUD und Ausführung von Automatisierungen |
| Google Calendar | /google-calendar | Kalender-Events und -Synchronisation |
| Organizations | /organizations | Organisationsverwaltung |
| Admin | /admin | Administrative Operationen |
| Email Builder | /email | E-Mail-Template-Verwaltung |
| Platform Engineering | /platform-engineering | Vereinheitlichte Provider-Ressourcen |
Allgemeine Muster
Fehlerantworten
Alle Endpoints geben standardisierte Fehlerantworten zurück:Paginierung
Listen-Endpoints unterstützen Paginierung über die Query-Parameteroffset und limit.
Rate Limiting
- Standard-Endpoints: 100 Anfragen/Minute pro Benutzer
- Voice-Endpoints: 20 Anfragen/Stunde, 50/Tag pro Benutzer
- KI-Endpoints: Begrenzt basierend auf Modellkosten