API : formulaires et PDF
Lister, créer, modifier, supprimer un formulaire et obtenir son PDF.
À quoi ça sert
Automatiser la création de formulaires, et modifier un formulaire existant (impossible depuis l’écran).
Prérequis et forfait
Clé d’API. Créer un formulaire ou générer un PDF « à la volée » compte dans le quota « formulaires générés ».
Étapes
- GET r=forms : liste de vos formulaires. POST r=forms : création, avec title, descr, template (classique, moderne, minimal, elegant, corporate) et questions[] (label, type, required, options).
- GET r=form&id=… : lire un formulaire. POST (ou PUT) r=form&id=… : modifier, avec seulement les champs à changer. DELETE r=form&id=… : supprimer (avec ses envois).
- POST r=form&id=… avec {"public": true} ou false : activer ou désactiver le lien public.
- GET r=pdf&id=… : PDF d’un formulaire enregistré (JSON avec pdf_base64, ou ajoutez &raw=1 pour le fichier). POST r=pdf avec une définition : PDF sans l’enregistrer (compte comme un formulaire généré).
- GET r=templates : modèles (avec aperçu SVG) et types de questions disponibles.
Résultat attendu
Création : 201 avec le formulaire. Modification : 200. Quota dépassé : 402 quota_exceeded.
Astuces
- Les types valides : text, long, email, tel, number, date, radio, check, select, yesno, sign.
- Les types radio, check et select exigent options (2 à 12).
Problèmes fréquents
- 422 « Type de question inconnu : « … » »
- Utilisez un des 11 types de GET r=templates.
- 422 « Modèle inconnu : … »
- Utilisez classique, moderne, minimal, elegant ou corporate.
Pages concernées
Ces pages demandent d’être connecté.
Articles liés
API REST : principes et limitesAdresse, authentification, format des réponses, erreurs et limites de l’API.API, clés et webhooksLes 11 types de questionsTexte court ou long, courriel, téléphone, nombre, date, choix unique, choix multiples, liste, oui/non et signature.Créer des formulairesCréer un formulaireL’assistant en deux étapes : titre et questions, puis modèle de page.Créer des formulaires