API-Zielgruppen und Kompatibilität
Welche VoiceStudio-Schnittstellen öffentlich, nur für Browser oder niemals für Kunden bestimmt sind.
Jede Control-Plane-Operation gehört zu einer Zielgruppe. Eine gemeinsame OpenAPI-Quelle macht eine Operation nicht öffentlich.
| Zielgruppe | Routen | Aufrufer | Hier veröffentlicht? |
|---|---|---|---|
| Öffentliche Entwickler-API | /v1/* | Entwicklerzugang mit begrenztem Umfang | Ja, in der Cloud-Projektion |
| Website-Edge-API | Geprüftes anonymes /v1/marketing/* | Formulare der Website | Nein |
| Dashboard/BFF-API | /dashboard/v1/* | Dashboard mit Same-Origin-Sitzung | Nein |
| Operator-API | Geprüftes /internal/v1/* | Plattformoperatoren | Nein |
| Interne Service-API | Andere /internal/v1/* | Private Dienste | Nein |
Website-Edge-, Operator- und interne Routen gehören niemals zur Kunden-API. Sie fehlen in /cloud-openapi.json, einschließlich ausschließlich von ihnen genutzter Schemas. Browser erhalten niemals Entwicklerzugänge und öffentliche Clients verwenden niemals das Dashboard-Sitzungscookie.
Kompatibilität
Es ist keine produktübergreifende Kompatibilitätsmenge veröffentlicht. Die lokale Version 0.5.0 und die Cloud-Vorschau 1.0.0 enthalten beide POST /v1/audio/transcriptions, doch Felder, Authentifizierung, Artifact- und Job-Verhalten, Timeouts und Fehler gelten nicht als austauschbar. Dafür müssen die Verhaltenstests in #71 für ein benanntes Versionspaar bestehen. Bis dahin bedeutet ein gemeinsamer Routenname Überschneidung, keine Kompatibilität.
Cloud veröffentlichen
Einen aktiven Cloud-Server im OpenAPI-Dokument oder in ausführbaren Beispielen zu veröffentlichen, ist ein Freigabeschritt. Er benötigt in dieser Reihenfolge:
- Verifiziertes Produktions-DNS und TLS.
- Smoke-Tests für Authentifizierung, öffentliches Routing und kundensichere Fehler.
- Kompatibilitäts- und Rollback-Prüfungen aus #71 für die genauen Versionen.
- Eine neu generierte Projektion ohne
unavailable.
Ein Rollback entfernt den aktiven Server. Dauerhafte Jobs, Artifacts und Idempotenzdatensätze bleiben unverändert.