Référence des réunions
Contrat REST candidat pour créer et lire les réunions Mastrao.
Le pilote expose cinq opérations REST versionnées sous /v1. Le contrat documenté est lié au commit Gateway f149a488c0c3b8cc4606200f27d36da3a0b2414e et à son snapshot OpenAPI vérifié en CI.
Opérations
| Méthode | Chemin | Scope requis |
|---|---|---|
| POST | /v1/meetings | meeting:create |
| POST | /v1/meetings/{meetingRef}/guest-links | meeting:share |
| GET | /v1/meetings/{meetingRef} | meeting:read |
| GET | /v1/meetings/{meetingRef}/transcript | transcript:read |
| GET | /v1/meetings/{meetingRef}/summary | summary:read |
Créer une réunion
Le corps accepte un titre facultatif et une planification facultative. Si schedule est présent, startAt, endAt et timezone sont tous requis. Les dates utilisent RFC 3339 et la fin doit suivre le début.
La création ne démarre ni la capture média, ni l'enregistrement vidéo, ni la transcription. Les règles d'admission et de consentement de Mastrao restent applicables dans la salle.
Les deux opérations POST exigent une Idempotency-Key de 16 à 128 caractères parmi les lettres ASCII, chiffres, ., _, ~ et -.
Lire une transcription
Une réponse non terminale contient uniquement le meetingRef et un statut parmi pending, processing, failed ou unavailable.
Quand le statut vaut available, la réponse contient :
- une référence et une version de transcription ;
- sa qualité,
completeouincomplete; - la langue lorsqu'elle est connue ;
- au maximum 250 segments dans la page ;
- le locuteur, les bornes temporelles et le texte de chaque segment ;
- un
nextCursoropaque, ounullpour la dernière page.
Passez le curseur suivant dans ?cursor=.... Un curseur appartient à une réunion et à une version de transcription précises.
Lire une synthèse
La synthèse utilise les mêmes statuts de disponibilité. Une synthèse available indique si son editorialState est machine_generated ou published, puis fournit le texte, les citations et les éléments structurés disponibles.
L'état machine_generated n'implique aucune validation humaine. L'état published indique qu'une version a été publiée.
Confidentialité des réponses
Les liens invités, transcriptions et synthèses sont servis avec des directives privées sans cache. Ne placez jamais un guestUrl, une clé ou le contenu d'une réunion dans des logs, métriques, traces ou messages d'erreur.