API publique
Les mêmes actions que la console. Une requête POST par action, en JSON.
Authentification
Créez une clé dans la console, rubrique Clés API. Elle ne s'affiche qu'une fois. Nous n'en gardons que l'empreinte.
Envoyez-la dans l'en-tête de chaque requête.
Authorization: Bearer sonde_...Une clé absente, inconnue ou révoquée renvoie 401. Chaque appel est inscrit à votre journal.
Erreurs
{ "erreur": { "code": "sonde_introuvable", "message": "Sonde introuvable." } }
400 entree_invalide 401 non_authentifie
404 sonde_introuvable 409 statut_incompatible
502 ia_indisponible, ia_reponse_invalidecreer_sonde
Crée une sonde en brouillon. Claude rédige le protocole : 2 questions de qualification, 3 à 4 questions chiffrées, 5 questions ouvertes.
Comptez 20 à 40 secondes.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/creer_sonde \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"question":"Comment nos clients choisissent-ils un logiciel de paie ?","cible":"DRH de PME","marque":"Acme"}'Réponse
{
"donnees": {
"id": "6f1c…",
"titre": "Le choix d'un logiciel de paie",
"protocole": [
{ "id": "a2…", "position": 1, "type": "choix_unique",
"texte": "Combien de salariés compte votre entreprise ?",
"options": ["Moins de 50", "50 à 249", "250 ou plus"],
"intention": "Qualifier la taille", "relances_max": 0 },
{ "id": "b7…", "position": 6, "type": "ouverte",
"texte": "Racontez-moi la dernière fois que…",
"options": [], "intention": "…", "relances_max": 2 }
]
}
}modifier_protocole
Applique une liste d'opérations, dans l'ordre : ajouter, modifier, supprimer, deplacer. Refusé avec 409 si la sonde n'est plus en brouillon.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/modifier_protocole \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…","operations":[{"op":"modifier","id":"a2…","champs":{"texte":"Combien de personnes employez-vous ?"}},{"op":"deplacer","id":"b7…","position":1},{"op":"supprimer","id":"c9…"},{"op":"ajouter","position":3,"question":{"type":"ouverte","texte":"Racontez-moi…","intention":"…"}}]}'Réponse
{ "donnees": { "id": "6f1c…", "protocole": [ … ] } }lancer_sonde
Passe la sonde en cours. Renvoie le lien répondant et deux invitations rédigées par Claude, une par e-mail et une pour LinkedIn.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/lancer_sonde \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…"}'Réponse
{
"donnees": {
"id": "6f1c…", "statut": "en_cours", "ouverte_le": "2026-11-18T13:00:00Z",
"lien": "https://sonde.diffairent.fr/r/9e4a…",
"invitations": {
"email": { "objet": "…", "corps": "…" },
"linkedin": "…"
}
}
}suivre_sonde
Renvoie le statut, le nombre de sessions terminées et le seuil de réponses.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/suivre_sonde \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…"}'Réponse
{ "donnees": { "id": "6f1c…", "statut": "en_cours", "sessions_terminees": 12, "seuil": 30 } }calculer_chiffres
Calcule les chiffres clés en base, sans modèle de langage. Pour chaque question fermée et chaque option : numérateur, effectif hors réponses passées, pourcentage arrondi à l'unité. Seules les sessions terminées comptent. Sous 10 réponses, aucun pourcentage n'est publié. Croisement facultatif par une option de qualification.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/calculer_chiffres \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…","croisement":{"question":"a2…","option":"Direction marketing"}}'Réponse
{
"donnees": {
"id": "6f1c…",
"croisement": { "question": "a2…", "option": "Direction marketing" },
"calcule_le": "2026-11-18T13:12:00Z",
"questions": [
{ "question": "c4…", "texte": "Combien de contenus publiez-vous par mois ?",
"position": 3, "type": "choix_unique", "effectif": 11, "statut": "publiable",
"options": [ { "option": "5 à 10", "numerateur": 7, "pourcentage": 64 }, … ] },
{ "question": "d8…", "texte": "…", "effectif": 6, "statut": "effectif insuffisant",
"options": [ { "option": "…", "numerateur": 2, "pourcentage": null } ] }
]
}
}reveler_barometre
Calcule les chiffres, puis Claude choisit une thèse, les cinq chiffres les plus parlants avec une phrase de lecture, et six à dix réponses à citer parmi celles dont l'auteur a accepté la citation. Claude ne produit aucun nombre : toute phrase dont un nombre ne correspond pas au chiffre référencé est refusée. Renvoie le dernier baromètre s'il existe, sauf avec regenerer.
Comptez 10 à 60 secondes la première fois.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/reveler_barometre \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…","regenerer":false}'Réponse
{
"donnees": {
"sonde": { "id": "6f1c…", "titre": "…", "marque": "Acme", "slug": null, "statut": "close" },
"barometre": { "id": "e1…", "these": "…", "publie": false },
"repondants": 54,
"chiffres": [
{ "id": "f3…", "pourcentage": 63, "numerateur": 34, "effectif": 54,
"phrase": "63 % des répondants, soit 34 sur 54, …",
"question": "…", "option": "…", "repartition": [ … ], "reponses": [ … ] }
],
"verbatims": [ { "id": "r9…", "texte": "…", "question": "…", "fil": [ … ] } ]
}
}obtenir_kit
Renvoie la dernière version des quatre contenus : rapport, posts_linkedin, communique, one_pager. Les génère avec Claude s'ils n'existent pas, ou avec regenerer. Tout texte contenant un pourcentage absent des chiffres calculés est refusé.
Comptez 20 à 60 secondes à la génération.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/obtenir_kit \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…"}'Réponse
{
"donnees": {
"id": "6f1c…", "barometre": "e1…",
"livrables": {
"rapport": { "version": 1, "contenu": "# …", "cree_le": "…" },
"posts_linkedin": { "version": 1, "contenu": "…
---
…" },
"communique": { … }, "one_pager": { … }
}
}
}modifier_livrable
Enregistre un texte modifié comme nouvelle version. Les mêmes vérifications s'appliquent : pourcentages calculés uniquement, aucun tiret cadratin, aucun post qui finit par une question.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/modifier_livrable \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…","type":"communique","contenu":"# …"}'Réponse
{ "donnees": { "id": "6f1c…", "livrables": { "communique": { "version": 2, … }, … } } }publier_barometre
Publie ou retire la page publique du baromètre. Rien n'est public tant que vous ne publiez pas.
Appel
curl -X POST https://sonde.diffairent.fr/api/public/v1/publier_barometre \
-H "Authorization: Bearer $SONDE_CLE" \
-H "Content-Type: application/json" \
-d '{"sonde":"6f1c…","publie":true}'Réponse
{ "donnees": { "id": "6f1c…", "publie": true, "url": "https://sonde.diffairent.fr/b/le-choix-d-un-logiciel-de-paie" } }De vraies personnes répondent. Claude (Anthropic) rédige le protocole, les invitations, les lectures et le kit. La base calcule les chiffres. Les réponses sont stockées dans l'Union européenne.