Publié le 2026-07-21L'API REST de Mirubiki permet de créer, lancer et récupérer les résultats de sondages par IA de manière programmatique.
Authentification
Tous les appels nécessitent une clé API transmise via le header X-API-Key.
curl -H "X-API-Key: mirubi...cle" https://www.mirubiki.com/api/v1/surveys
Les clés sont disponibles depuis votre tableau de bord API (plans Enterprise et Admin uniquement).
Rate Limiting
| Plan |
Limite |
Fenêtre |
| Enterprise |
100 requêtes |
1 minute glissante |
| Admin |
500 requêtes |
1 minute glissante |
En cas de dépassement, l'API retourne 429 Too Many Requests avec un header X-RateLimit-Reset.
Réponses
Toutes les réponses suivent le format :
{ "data": { ... }, "error": null } # Succès
{ "data": null, "error": "Message d'erreur" } # Erreur
🔑 Gestion des clés
GET /api/v1/api-keys
Liste les clés API de votre compte.
curl -H "X-API-Key: ***" https://www.mirubiki.com/api/v1/api-keys
POST /api/v1/api-keys
Crée une nouvelle clé API.
curl -X POST -H "X-API-Key: ***" \
-H "Content-Type: application/json" \
-d '{"nom": "Ma clé de production"}' \
https://www.mirubiki.com/api/v1/api-keys
DELETE /api/v1/api-keys/{id}
Révoque une clé API.
curl -X DELETE -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/api-keys/42
📋 Sondages
POST /api/v1/surveys
Crée un sondage (brouillon).
curl -X POST -H "X-API-Key: ***" \
-H "Content-Type: application/json" \
-d '{
"titre": "Test produit",
"contexte": "Nous lançons un nouveau produit...",
"questions": [
{ "texte": "Acheteriez-vous ce produit ?", "type": "choix_unique", "options": ["Oui","Non","Peut-être"] },
{ "texte": "Quel prix seriez-vous prêt à payer ?", "type": "libre" }
],
"nb_personas": 50,
"filtres": { "age": ["25-34"], "sex": "F" }
}' \
https://www.mirubiki.com/api/v1/surveys
POST /api/v1/surveys/{id}/launch
Lance un sondage (brouillon → en cours).
curl -X POST -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/surveys/abc123/launch
GET /api/v1/surveys/{id}/status
Récupère le statut et la progression d'un sondage.
curl -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/surveys/abc123/status
GET /api/v1/surveys/{id}/results
Récupère les résultats d'un sondage terminé.
curl -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/surveys/abc123/results
GET /api/v1/surveys
Liste les sondages de votre compte (paginé).
curl -H "X-API-Key: ***" \
"https://www.mirubiki.com/api/v1/surveys?limit=20&offset=0"
DELETE /api/v1/surveys/{id}
Supprime un sondage.
curl -X DELETE -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/surveys/abc123
👥 Focus Groups
Les Focus Groups sont des discussions de groupe avec 2 à 8 personas, modérées par IA.
POST /api/v1/focus
Crée un focus group.
curl -X POST -H "X-API-Key: ***" \
-H "Content-Type: application/json" \
-d '{
"titre": "Avis sur email assurance",
"guide": "Comparer deux propositions",
"nb_personas": 4,
"max_turns": 6,
"filtres": { "sexe": "F", "ages": ["25-40"] }
}' \
https://www.mirubiki.com/api/v1/focus
GET /api/v1/focus
Liste les focus groups (paginé).
curl -H "X-API-Key: ***" \
"https://www.mirubiki.com/api/v1/focus?limit=20&offset=0"
GET /api/v1/focus/{id}
Détails d'une session focus group.
curl -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/focus/abc123
GET /api/v1/focus/{id}/transcript
Transcript texte de la discussion.
curl -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/focus/abc123/transcript
DELETE /api/v1/focus/{id}
Supprime un focus group.
curl -X DELETE -H "X-API-Key: ***" \
https://www.mirubiki.com/api/v1/focus/abc123
À lire aussi : L'API depuis Python · Créer votre premier sondage
Mirubiki interroge 25 profils représentatifs de la population française en quelques minutes — testez votre idée.
