Auparavant, l’envoi d’un formulaire via l’API nécessitait de référencer chaque champ par son slug généré automatiquement. Vous deviez donc d’abord récupérer la structure de votre formulaire, identifier le slug de chaque champ, puis associer vos données en conséquence.
➔ Ancien exemple (avec les slugs de champs) :
{
"rzkxaWgNY7": "some short text",
"EqQAWBKdVA": 50,
"HbyBQV04yU": "no",
"Lb2J7AksMg": "choice_x8dNpnG1pV",
"6Qr5btT9ad": "[email protected]"
}
Avec cette mise à jour, vous pouvez désormais utiliser directement des alias de champs dans le corps de votre requête JSON. Vos requêtes sont ainsi plus faciles à lire, à maintenir et à déboguer.
➔ Nouvel exemple (avec les alias de champs) :
{
"country_of_destination": "Canada",
"case_type": "Immigration",
"full_name": "Sarah Johnson",
"job_title": "Software Engineer",
"email": "[email protected]",
"nationality": "United States",
"accepted_terms": "yes",
"submit_by_alias": true
}
ℹ️️ Vous pouvez toujours envoyer des formulaires à l’aide des slugs de champs si vous le préférez : les deux méthodes restent prises en charge pour une flexibilité maximale.
Comment utiliser les alias de champs dans les envois via l’API
Pour envoyer des formulaires à l’aide d’alias plutôt que de slugs :
Attribuez un alias à chaque champ de votre formulaire (les alias doivent être uniques) :
Ajoutez
"submit_by_alias": trueau corps de votre requête.Utilisez les alias de champs comme clés pour la valeur de chaque champ.
Évitez de mélanger alias et slugs dans une même requête : choisissez une seule méthode par appel.
Points de terminaison pris en charge
Cette amélioration fonctionne avec toutes les versions de l’API (v1.0, v2.0 et v3.0) pour :
Les points de terminaison d’envoi de formulaires :
/form-displays/{slug}/{slug}/submit/Les points de terminaison authentifiés de création de lignes :
/forms/{slug}/rows/
La méthode basée sur les slugs reste entièrement prise en charge pour assurer la rétrocompatibilité.
ℹ️️ En savoir plus
Consultez la documentation de l’API Formaloo pour tous les détails de mise en œuvre, les exigences d’authentification et des exemples de réponses.