Clé API
Une clé API est une chaîne secrète qui prouve qu'un autre système est autorisé à lire vos données. Elle fonctionne comme un mot de passe, sauf qu'un programme la fournit à la place d'une personne, et qu'elle reste valide jusqu'à ce que vous la révoquiez.
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.
Créez la clé dans les paramètres : elle n'est affichée qu'une seule fois. Enregistrez-la immédiatement dans une variable d'environnement ou un gestionnaire de secrets sur votre serveur. Vous ne pourrez pas la relire ensuite, car elle est stockée sous une forme à partir de laquelle la valeur d'origine ne peut pas être reconstituée.
L'erreur la plus courante consiste à placer la clé dans le JavaScript de la page. Le code source du navigateur est public : n'importe qui peut copier la clé et télécharger les réponses de tous vos formulaires. Les appels à l'API doivent donc passer par un serveur qui détient la clé et ne renvoie que ce qui est destiné à être public.
Si une clé fuite, inutile de chercher à savoir si quelqu'un l'a utilisée : révoquez-la et générez-en une nouvelle. La révocation est immédiate et l'ancienne clé cesse de fonctionner.
En pratique
- La clé doit être stockée dans une variable d'environnement côté serveur, et non dans un dépôt de code ni dans le front-end.
- Privilégiez une clé distincte par intégration, afin de pouvoir révoquer uniquement celle-ci.
- Renouvelez la clé lorsqu'une personne qui la connaissait quitte l'équipe.
FAQ
Où créer une clé API ?
Dans Paramètres → Clés API. Elle n'est affichée qu'une seule fois.
Comment la clé est-elle envoyée ?
Dans un en-tête Authorization: Bearer <clé>, ou dans un en-tête x-api-key.
Que se passe-t-il lorsque je révoque une clé ?
Elle cesse immédiatement de fonctionner, et les intégrations qui l'utilisent reçoivent une erreur 401.
Pages connexes
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 →