API REST

Lorsque vous souhaitez afficher les réponses sur votre propre site ou les importer dans votre système selon un calendrier, utilisez l'API REST. Elle renvoie du JSON, s'authentifie avec une clé API et accepte les mêmes filtres que le tableau des résultats.

Commencer gratuitement →Tarifs

Bon à savoir : l'éditeur et le compte Gatherino sont disponibles en anglais ou en tchèque. Les formulaires que vos répondants remplissent peuvent s'afficher dans 18 langues, dont le français.

Ce que permet l'API

  • Lister les formulaires d'un espace de travail et récupérer un formulaire avec sa structure.
  • Lister les réponses avec des filtres : par formulaire, statut, période, recherche en texte intégral, ainsi que tri.
  • Récupérer une réponse unique.
  • Mettre à jour le statut d'une réponse.
  • Soumettre une réponse à un formulaire par programmation : utile pour des migrations ou une interface sur mesure.

Récupérer les réponses

Authentification via l'en-tête Authorization (un en-tête x-api-key fonctionne aussi) :

curl "https://gatherino.com/api/v1/submissions?formId=FORM_ID&limit=50" \
  -H "Authorization: Bearer gk_your_key"

# response
{ "items": [ { "id": "…", "status": "NEW", "createdAt": "…",
               "data": { "field_1778…": "Jan Vondráček" } } ],
  "total": 672, "page": 1, "limit": 50, "totalPages": 14 }

Premiers pas

  1. 1

    Créer une clé API

    Dans Paramètres → Clés API. La clé n'est affichée qu'une seule fois : enregistrez-la immédiatement.

  2. 2

    Effectuer votre premier appel

    Essayez de lister les formulaires pour vérifier que la clé fonctionne et récupérer l'identifiant du formulaire.

  3. 3

    Associer les identifiants de champ aux libellés

    Le détail du formulaire renvoie l'identifiant et le libellé de chaque champ : créez une table de correspondance à partir de ces données. Les identifiants de champ sont stables : une seule récupération suffit.

  4. 4

    Gérer la pagination

    Le maximum est de 100 réponses par requête. Pour en obtenir davantage, parcourez les pages jusqu'à la dernière.

La clé API doit rester sur votre serveur, jamais dans le JavaScript du navigateur : n'importe qui pourrait la lire et télécharger toutes vos réponses. Si vous publiez des réponses, n'exposez que les champs destinés à la publication, jamais de données personnelles.

FAQ

Comment l'API s'authentifie-t-elle ?

Avec une clé API : soit un en-tête Authorization: Bearer <clé>, soit un en-tête x-api-key. Une clé invalide renvoie une erreur 401.

Combien de réponses par requête ?

Jusqu'à 100. La réponse inclut total et totalPages afin de vous permettre de parcourir les pages suivantes.

Pourquoi les clés de données ressemblent-elles à field_1778… ?

Ce sont les identifiants des champs du formulaire. Récupérez leurs libellés dans le détail du formulaire et conservez la correspondance de votre côté.

L'API gère-t-elle les caractères accentués ?

Oui, tout est encodé en UTF-8 : le tchèque et les autres langues fonctionnent sans problème.

Pages connexes

Documentation de l'APIWebhooksGestion des réponsesDiscordGoogle Sheets

Essayez Gatherino gratuitement

Offre gratuite : 3 formulaires et 100 réponses par mois. Sans carte bancaire, données hébergées dans l'UE.

Commencer gratuitement →