Públicos de API y compatibilidad
Qué interfaces de VoiceStudio son públicas, solo para navegador o nunca están destinadas a clientes.
Cada operación del plano de control pertenece a un público. Compartir una fuente OpenAPI no hace pública una operación.
| Público | Rutas | Quién llama | ¿Publicado aquí? |
|---|---|---|---|
| API pública para desarrolladores | /v1/* | Credencial de desarrollador con alcance limitado | Sí, en la proyección Cloud |
| API de borde del sitio | /v1/marketing/* anónimo revisado | Formularios del sitio | No |
| API de panel/BFF | /dashboard/v1/* | Panel con sesión del mismo origen | No |
| API de operadores | /internal/v1/* revisado | Operadores de la plataforma | No |
| API interna de servicios | Otros /internal/v1/* | Servicios privados | No |
Las rutas de borde del sitio, operadores e internas nunca son superficie de API para clientes. No aparecen en /cloud-openapi.json, incluidos los esquemas exclusivos. Los navegadores nunca reciben una credencial de desarrollador y los clientes públicos nunca usan la cookie de sesión del panel.
Compatibilidad
No se ha publicado ningún subconjunto de compatibilidad entre productos. Los contratos local 0.5.0 y de vista previa Cloud 1.0.0 incluyen POST /v1/audio/transcriptions, pero los campos, la autenticación, el comportamiento de Artifact y Job, los tiempos de espera y los errores no se declaran intercambiables. Para ello deben pasar las pruebas de comportamiento de #71 para un par concreto de versiones. Hasta entonces, un nombre de ruta común es coincidencia, no compatibilidad.
Publicación de Cloud
Publicar un servidor Cloud activo en el documento OpenAPI o en ejemplos ejecutables es un paso de lanzamiento. Requiere, en este orden:
- DNS y TLS de producción verificados.
- Pruebas básicas de autenticación, enrutamiento público y errores seguros para clientes.
- Comprobaciones de compatibilidad y reversión de #71 para las versiones exactas.
- Una proyección regenerada que ya no indique
unavailable.
La reversión elimina el servidor activo. Los Jobs, Artifacts y registros duraderos de idempotencia permanecen como están.