S'inscrire via un formulaire
Le point de terminaison où postent les visiteurs d'un formulaire publié. Il n'exige aucune identification, appelez-le donc depuis un navigateur ou depuis votre propre serveur, depuis n'importe quelle origine.
Exécute le véritable appel sur votre espace de travail.
POST /subscribe/{formId}
Le point de terminaison où postent les visiteurs d'un formulaire publié. Il n'exige aucune identification, appelez-le donc depuis un navigateur ou depuis votre propre serveur, depuis n'importe quelle origine.
Exemple
Envoyez les réponses sous la clé de chaque champ, au premier niveau ou dans values. Avec Accept: application/json ou un corps JSON, la réponse est en JSON. Un simple formulaire HTML est plutôt redirigé avec un 303.
curl -X POST "$OE/subscribe/frm_3b9d2e7a1c4f80d56e2a9b14" -H 'content-type: application/json' -d '{ "email": "[email protected]", "first_name": "Ann", "consent": true}'{ "object": "form_subscription", "formId": "frm_3b9d2e7a1c4f80d56e2a9b14", "outcome": "pending", "redirectUrl": null}outcome vaut added quand la personne est désormais dans les audiences, ou pending sur un formulaire en double opt-in, où elle les rejoint une fois qu'elle a confirmé par e-mail. Cet e-mail part après cette réponse, sauf si ce formulaire a écrit à l'adresse dans les dix dernières minutes ou si l'adresse a déjà reçu aujourd'hui cinq e-mails de cet espace de travail.
Une réponse manquante ou erronée donne un 422 invalid_form_submission. L'erreur porte fields, une liste de { "key", "error" } avec des raisons comme required, email ou option.
Un formulaire en pause répond 409 form_closed, un formulaire inconnu ou non publié 404 form_not_found, et trop d'inscriptions depuis un même réseau donnent 429 form_rate_limited. Un simple formulaire HTML reçoit à la place un 303 vers la page hébergée.
Les réponses à des clés que le formulaire n'a pas sont ignorées, et les clés commençant par oe_ ne sont jamais enregistrées. oe_source nomme la page où se trouvait le formulaire, et vaut par défaut l'en-tête Referer.
