Publics de l’API et compatibilité
Quelles interfaces VoiceStudio sont publiques, réservées au navigateur ou jamais destinées aux clients.
Chaque opération du plan de contrôle appartient à un public. Une source OpenAPI commune ne rend pas une opération publique.
| Public | Routes | Qui l’appelle | Publié ici ? |
|---|---|---|---|
| API publique développeur | /v1/* | Identifiant développeur à portée limitée | Oui, dans la projection Cloud |
| API de périphérie du site | /v1/marketing/* anonyme vérifié | Formulaires du site | Non |
| API tableau de bord/BFF | /dashboard/v1/* | Tableau de bord avec session de même origine | Non |
| API opérateur | /internal/v1/* vérifié | Opérateurs de la plateforme | Non |
| API interne de service | Autres /internal/v1/* | Services privés | Non |
Les routes de périphérie du site, opérateur et internes ne font jamais partie de l’API client. Elles sont absentes de /cloud-openapi.json, y compris leurs schémas exclusifs. Les navigateurs ne reçoivent jamais d’identifiant développeur et les clients publics n’utilisent jamais le cookie de session du tableau de bord.
Compatibilité
Aucun sous-ensemble de compatibilité entre produits n’est publié. Les contrats local 0.5.0 et Cloud en aperçu 1.0.0 contiennent tous deux POST /v1/audio/transcriptions, mais les champs, l’authentification, le comportement des Artifact et Job, les délais et les erreurs ne sont pas déclarés interchangeables. Les tests de comportement de #71 doivent réussir pour une paire de versions définie. Jusque-là, un nom de route commun indique un chevauchement, pas une compatibilité.
Publier Cloud
Publier un serveur Cloud actif dans le document OpenAPI ou dans des exemples exécutables est une étape de publication. Elle exige, dans cet ordre :
- DNS et TLS de production vérifiés.
- Tests de base de l’authentification, du routage public et des échecs sûrs pour les clients.
- Vérifications de compatibilité et de retour arrière de #71 pour les versions exactes.
- Projection régénérée ne contenant plus
unavailable.
Le retour arrière retire le serveur actif. Les Jobs, Artifacts et enregistrements d’idempotence durables restent inchangés.