Audiens API dan kompatibilitas
Antarmuka VoiceStudio yang publik, khusus browser, dan yang tidak pernah menjadi antarmuka pelanggan.
Setiap operasi control plane memiliki satu audiens. Berbagi sumber OpenAPI tidak menjadikan operasi publik.
| Audiens | Rute | Pemanggil | Diterbitkan di sini? |
|---|---|---|---|
| API pengembang publik | /v1/* | Kredensial pengembang dengan cakupan terbatas | Ya, dalam proyeksi Cloud |
| API edge situs | /v1/marketing/* anonim yang ditinjau | Formulir situs sendiri | Tidak |
| API dashboard/BFF | /dashboard/v1/* | Dashboard dengan sesi same-origin | Tidak |
| API operator | /internal/v1/* yang ditinjau | Operator platform | Tidak |
| API layanan internal | /internal/v1/* lainnya | Layanan privat | Tidak |
Rute edge situs, operator, dan internal tidak pernah menjadi API pelanggan. Rute ini tidak ada di /cloud-openapi.json, termasuk skema yang hanya digunakannya. Browser tidak pernah menerima kredensial pengembang, dan klien publik tidak pernah menggunakan cookie sesi dashboard.
Kompatibilitas
Belum ada subset kompatibilitas lintas produk yang dirilis. Kontrak lokal 0.5.0 dan pratinjau Cloud 1.0.0 sama-sama memiliki POST /v1/audio/transcriptions, tetapi bidang, autentikasi, perilaku Artifact dan Job, batas waktu, serta kesalahan tidak dinyatakan dapat dipertukarkan. Pengujian perilaku di #71 harus lulus untuk pasangan versi yang disebutkan. Sampai saat itu, nama rute yang sama berarti tumpang tindih, bukan kompatibilitas.
Merilis Cloud
Menerbitkan server Cloud aktif dalam dokumen OpenAPI atau contoh yang dapat dijalankan adalah langkah rilis. Diperlukan, secara berurutan:
- DNS dan TLS produksi yang terverifikasi.
- Uji smoke untuk autentikasi, routing publik, dan kegagalan yang aman bagi pelanggan.
- Pemeriksaan kompatibilitas dan rollback #71 untuk versi yang tepat.
- Proyeksi yang dibuat ulang dan tidak lagi menyatakan
unavailable.
Rollback menghapus server aktif. Job, Artifact, dan catatan idempotensi yang tahan lama tetap seperti semula.