API : modèles PDF et remplissage

Ajouter un PDF, relier ses champs et le remplir par programme.

À quoi ça sert

Automatiser le remplissage de vos formulaires PDF officiels depuis votre logiciel.

Prérequis et forfait

Clé d’API. Seuls les PDF à champs remplissables (AcroForm) sont acceptés. Limites du forfait : modèles et remplissages.

Étapes

1. GET r=models : liste. POST r=models avec name et pdf_base64 (15 Mo maximum) : ajoute un modèle et renvoie ses champs.
2. GET r=model&id=… : lire un modèle avec ses champs. POST r=model&id=… : enregistrer form_id et map (champ du PDF → a:<texte de la question>, x:nom, x:email, x:date, x:cabinet, x:pro). DELETE : supprimer.
3. POST r=fill avec model_id, send_id (réponse REMPLIE) et, au besoin, context ({"x:cabinet":"…","x:pro":"…"}) : renvoie le PDF rempli en pdf_base64 (ou le fichier avec &raw=1) et fields_filled.

Résultat attendu

Le PDF rempli est retourné ; chaque remplissage compte dans le quota du mois.

Astuces

• Les liens invalides sont écartés à l’enregistrement.
• GET r=usage affiche models et fills_month (utilisé / limite).

Problèmes fréquents

422 « Ce PDF ne contient aucun champ remplissable (PDF « à plat »). … »

Voir « Quels PDF peut-on remplir ? ».

422 « Reliez d’abord au moins un champ du PDF aux réponses. »

Enregistrez map avant de remplir.

402 quota_exceeded (quota models ou fills)

Limite du forfait atteinte.

Pages concernées

Référence de l’API

Ces pages demandent d’être connecté.

Articles liés