Über ein Formular anmelden
Der Endpunkt, an den die Besucher eines veröffentlichten Formulars senden. Er braucht keine Zugangsdaten, rufen Sie ihn also aus einem Browser oder von Ihrem eigenen Server auf, von jedem Ursprung aus.
Führt den echten Aufruf in Ihrem Workspace aus.
POST /subscribe/{formId}
Der Endpunkt, an den die Besucher eines veröffentlichten Formulars senden. Er braucht keine Zugangsdaten, rufen Sie ihn also aus einem Browser oder von Ihrem eigenen Server auf, von jedem Ursprung aus.
Beispiel
Senden Sie die Antworten mit dem Feldschlüssel als Namen, auf oberster Ebene oder unter values. Mit Accept: application/json oder einem JSON-Body ist die Antwort JSON. Ein reines HTML-Formular wird stattdessen mit einem 303 weitergeleitet.
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 ist added, wenn die Person jetzt in den Audiences ist, oder pending bei einem Formular mit Double-Opt-in, wo sie den Audiences beitritt, sobald sie per E-Mail bestätigt. Diese E-Mail geht nach dieser Antwort hinaus, es sei denn, dieses Formular hat der Adresse in den letzten zehn Minuten geschrieben oder die Adresse hat heute schon fünf E-Mails aus diesem Workspace erhalten.
Eine fehlende oder falsche Antwort ergibt ein 422 invalid_form_submission. Der Fehler trägt fields, eine Liste von { "key", "error" } mit Gründen wie required, email oder option.
Ein pausiertes Formular antwortet mit 409 form_closed, ein unbekanntes oder unveröffentlichtes mit 404 form_not_found, und zu viele Anmeldungen aus einem Netzwerk ergeben 429 form_rate_limited. Ein reines HTML-Formular wird stattdessen mit einem 303 auf die gehostete Seite weitergeleitet.
Antworten zu Schlüsseln, die das Formular nicht hat, werden ignoriert, und Schlüssel, die mit oe_ beginnen, werden nie gespeichert. oe_source nennt die Seite, auf der das Formular war, und ist standardmäßig der Referer-Header.
