L’API REST : bases
Adresse, authentification, codes d’erreur et limites.
À quoi ça sert
Piloter Sondagix depuis un autre logiciel.
Prérequis et forfait
Forfaits Pro et Premium.
Étapes
- Adresse : https://votre-domaine/api.php?r=RESSOURCE.
- En-tête obligatoire : Authorization: Bearer sx_… (votre clé).
- Corps JSON en UTF-8 pour POST ; réponses JSON.
- Limite : 600 requêtes par 15 minutes par clé (429 au-delà).
- Codes : 401 clé manquante ou invalide, 402 forfait ou quota, 404 introuvable, 405 méthode, 409 conflit, 422 données invalides.
- Page « Intégrations » : exemples curl prêts à copier.
Résultat attendu
Vous pouvez lire et écrire vos sondages, invitations, réponses et webhooks par programme.
Astuces
- Un 402 contient « code » (plan_required ou quota_exceeded) et « upgrade_url » : un lien pour payer.
- Ressources : usage, templates, surveys, survey, results, responses, response, invites, hooks, hook, hook_test.
Problèmes fréquents
- 401 « Clé d’API manquante ou invalide ».
- Vérifiez l’en-tête (Bearer, une seule espace) et que la clé n’est pas révoquée.
- 402 plan_required.
- Le compte est au Gratuit.
Pages concernées
Ces pages demandent d’être connecté.
Articles liés
Créer et révoquer une clé d’APIUne clé permet à un autre outil d’agir sur votre compte Sondagix.API, clés et webhooksAPI : créer et gérer des sondagesCréer un sondage (avec un modèle ou vos questions), le publier, le modifier, le clore ou le supprimer.API, clés et webhooksAPI : invitations à usage uniqueCréer des liens personnels depuis un autre outil.API, clés et webhooksAPI : enregistrer et lire des réponsesRecevoir des réponses depuis un autre outil, ou les lire.API, clés et webhooksAPI : lire les résultatsObtenir une synthèse par question.API, clés et webhooks