Démarrage rapide

Qualification en cours. Les commandes ci-dessous correspondent au contrat candidat exact. Elles deviennent exécutables lorsque Mastrao remet l'URL staging et la clé de test.

Préparer les variables

export MASTRAO_API_BASE_URL="https://URL-FOURNIE-PAR-MASTRAO"
export MASTRAO_API_KEY="CLE-REMISE-PAR-LIEN-SECURISE"

1. Créer une réunion

Conservez la même Idempotency-Key si la réponse réseau est inconnue.

curl --fail-with-body \
  --request POST \
  --url "$MASTRAO_API_BASE_URL/v1/meetings" \
  --header "Authorization: Bearer $MASTRAO_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: lds-rendez-vous-20261017-0001" \
  --data '{
    "title": "Rendez-vous client",
    "schedule": {
      "startAt": "2026-11-04T09:00:00+01:00",
      "endAt": "2026-11-04T10:00:00+01:00",
      "timezone": "Europe/Paris"
    }
  }'

La réponse 201 contient un meetingRef opaque :

{
  "meetingRef": "meeting_0123456789abcdef",
  "meetingState": "created",
  "title": "Rendez-vous client",
  "schedule": {
    "startAt": "2026-11-04T09:00:00+01:00",
    "endAt": "2026-11-04T10:00:00+01:00",
    "timezone": "Europe/Paris"
  }
}

2. Créer un lien invité

export MEETING_REF="meeting_0123456789abcdef"

curl --fail-with-body \
  --request POST \
  --url "$MASTRAO_API_BASE_URL/v1/meetings/$MEETING_REF/guest-links" \
  --header "Authorization: Bearer $MASTRAO_API_KEY" \
  --header "Idempotency-Key: lds-lien-invite-20261017-0001"

La réponse contient un guestUrl sensible. Ne le journalisez pas et transmettez-le uniquement aux participants concernés.

3. Suivre la réunion

curl --fail-with-body \
  --url "$MASTRAO_API_BASE_URL/v1/meetings/$MEETING_REF" \
  --header "Authorization: Bearer $MASTRAO_API_KEY"

L'état évolue parmi created, in_progress, ending, ended, cancelled et failed.

4. Récupérer les résultats

Après la fin de la réunion, interrogez séparément les deux ressources :

curl --fail-with-body \
  --url "$MASTRAO_API_BASE_URL/v1/meetings/$MEETING_REF/transcript" \
  --header "Authorization: Bearer $MASTRAO_API_KEY"

curl --fail-with-body \
  --url "$MASTRAO_API_BASE_URL/v1/meetings/$MEETING_REF/summary" \
  --header "Authorization: Bearer $MASTRAO_API_KEY"

Les réponses peuvent rester pending ou processing avant de devenir available. Espacez vos lectures et arrêtez le polling à l'échéance définie par votre application.