API des formulaires
Chaque formulaire peut être une API : votre propre site ou application lui envoie des réponses.
L’activer
- 1Activez les API de formulaires dans les paramètres Formulaires de la base.
- 2Ouvrez l’onglet API du formulaire et activez-le.
- 3Copiez sa clé, affichée une seule fois ; faites-en une nouvelle à tout moment.
Points d’accès
- GET /api/forms/:id
- Les champs du formulaire, pour l’afficher.
- POST /api/forms/:id/submissions
- Envoyer des réponses, vérifiées comme le formulaire les vérifie.
- GET /api/forms/:id/submissions
- Lire les soumissions, les plus anciennes d’abord, avec la clé.
- GET /api/forms/:id/submissions/:sid
- Lire une soumission.
Ses règles
- Envoyez la clé en Authorization: Bearer <clé>.
- Un formulaire ouvert accepte des soumissions sans clé ; les lire la demande toujours.
- Chaque adresse envoie tant de soumissions par minute, selon votre offre.
- Seul ce que demande le formulaire est gardé, fichiers compris.
Où vont les réponses
Chaque soumission est gardée comme une réponse du formulaire, que l’application soit ouverte ou non, et lance vos workflows.