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_invalide

creer_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.