Vue d'ensemble de l'API
L’API REST Meetingize v1 donne un accès programmatique à vos réunions, transcriptions diarisées, comptes rendus IA et documents, vous permet de créer des réunions à partir d’enregistrements et de générer des documents, et gère les webhooks. C’est une API JSON sur HTTPS décrite par une spécification OpenAPI 3.1.
URL de base
Section intitulée « URL de base »Tous les endpoints se trouvent sous :
https://app.meetingize.com/api/v1Les requêtes doivent utiliser HTTPS et porter un identifiant bearer (voir Authentification).
Versionnement
Section intitulée « Versionnement »La version de l’API est 2026-10-01. Elle est renvoyée dans l’en-tête de réponse Meetingize-Version et dans le
champ api_version des événements webhook. Des ajouts rétrocompatibles (nouveaux champs, nouveaux endpoints,
nouveaux types d’événements) peuvent survenir à tout moment : ignorez les champs inconnus. Les changements majeurs
arriveront avec une nouvelle version.
Conventions
Section intitulée « Conventions »- JSON en UTF-8, dates en ISO 8601 UTC (
2026-10-11T14:03:22Z). - Les montants sont des chaînes décimales en EUR (
"0.0123"), jamais des flottants. - Chaque réponse porte un en-tête
X-Request-Id, également présent dans les corps d’erreur. Communiquez-le au support lorsque vous signalez un problème. - Les erreurs suivent le format RFC 9457 problem details avec un
codestable : voir Erreurs et limites.
Identifiants
Section intitulée « Identifiants »| Objet | Format | Exemple |
|---|---|---|
| Réunion | UUID | 1b9e5c4a-... |
| Document | doc_<n> | doc_1234 |
| Modèle | tpl_<n> | tpl_42 |
| Job | job_<hex> | job_9b0c2d... |
| Endpoint webhook | we_<hex> | we_3f... |
| Événement webhook / livraison | evt_<hex> / whd_<hex> | |
| Écriture de grand livre | led_<hex> |
Pagination
Section intitulée « Pagination »Les endpoints de liste utilisent la pagination par curseur :
GET /v1/meetings?limit=20&cursor=eyJ...{ "data": [ ... ], "has_more": true, "next_cursor": "eyJ..." }limit vaut 20 par défaut (max 100 sur la plupart des listes). Continuez à appeler avec cursor=next_cursor tant
que has_more vaut true. Un curseur altéré renvoie 400 invalid_cursor.
Idempotence
Section intitulée « Idempotence »Toutes les requêtes POST acceptent un en-tête Idempotency-Key (une chaîne unique quelconque, par exemple un
UUID), mémorisé pendant 24 heures :
- même clé et même corps : la réponse d’origine est rejouée, avec
Idempotent-Replayed: true; - même clé, corps différent :
422 idempotency_key_reused; - même clé alors que la première requête est encore en cours :
409 idempotency_key_in_use.
Envoyez-en toujours une lorsque vous créez des jobs, afin qu’une nouvelle tentative réseau ne démarre jamais deux fois la même transcription.
Endpoints en un coup d’œil
Section intitulée « Endpoints en un coup d’œil »| Domaine | Endpoints | Scope |
|---|---|---|
| Compte | GET /me | tout |
| Réunions | GET /meetings, GET /meetings/{id}, /summary, /participants, /export | read:meetings |
| Transcriptions | GET /meetings/{id}/transcript | read:transcripts |
| Modèles | GET /templates, GET /templates/{id}, GET /personas | read:meetings ou write:documents |
| Documents | POST /meetings/{id}/documents, GET /documents, GET /documents/{id} | write:documents / read:documents |
| Créer, mettre à jour, supprimer des réunions | POST /meetings, PATCH /meetings/{id}, DELETE /meetings/{id} | write:meetings |
| Feedback | POST /feedback | tout |
| Jobs | GET /jobs, GET /jobs/{id} | tout |
| Usage | GET /usage, GET /usage/ledger | read:usage |
| Webhooks | /webhook_endpoints et sous-ressources | webhooks |
Tous les détails dans la référence et l’explorateur d’API interactif.