API : créer et gérer des sondages
Créer un sondage (avec un modèle ou vos questions), le publier, le modifier, le clore ou le supprimer.
À quoi ça sert
Automatiser la création de sondages (un par client, un par évènement).
Prérequis et forfait
Forfaits Pro et Premium.
Étapes
- GET r=templates : liste des modèles et des types de questions.
- POST r=surveys avec {"template":"satisfaction-client","title":"…","status":"active"} ou avec {"title":"…","questions":[…]}.
- GET r=survey&id=… pour lire ; POST r=survey&id=… pour modifier titre, description, thanks, settings, questions (seulement s’il n’y a pas encore de réponses) ou status (active, closed, draft) ; DELETE pour supprimer.
- GET r=surveys liste les sondages.
Résultat attendu
Le sondage est créé en brouillon (ou actif si demandé) et la réponse contient son public_url et ses questions avec leurs clés.
Astuces
- Dans « show_if », « q » peut être le numéro de la question (à partir de 1) à la création.
- Si la publication dépasse la limite de sondages actifs, la réponse est 402 et le sondage reste en brouillon.
Problèmes fréquents
- 409 « Ce sondage a déjà des réponses ».
- Les questions ne se remplacent plus après la première réponse : dupliquez ou créez un nouveau sondage.
- 422 « Question 3 : … ».
- Le message indique la question et la règle violée.
Pages concernées
Ces pages demandent d’être connecté.