getnlsubscriberform

Funktion
Diese Funktion liefert ein JSON-Array zurück für die benötigten Felder des Newsletter-Formulars. Dies ermöglicht, Verowa-Newsletter-Registration von jedem System aus entgegenzunehmen, ohne ein iFrame einbinden zu müssen. Das Array kann in Ihrer Applikation verwendet werden, um die Felder aufzubauen. Subscriber ID (nl_subs_id) 0 ist für einen neuen Abonnenten des Newsletters.

Um die Formulardaten an die API zu schicken, benutzen Sie bitte die Methode updatenlsubscriber. Für den Versand benötigen Sie im Formular einen entsprechenden Button, dieser wird nicht von der API geliefert.

Resource URL
https://api.verowa.ch/getnlsubscriberform/:instance/:key_or_mail/

Parameter
– Ihr Instanzname :instance
– Identifikation: entweder der Schlüssel oder die Mailadresse :key_or_mail
Für neue Anmeldungen geben Sie die Mailadresse mit. Stammt der Link aus einem automatischen Verowa-Mailing, wird stattdessen der Schlüssel verwendet. Wird diese Funktion mit dem Schlüssel aufgerufen, liefert Verowa die Formularfelder mit den Daten der jeweiligen Newsletter-Anmeldung.

Beispielanfrage
GET https://api.verowa.ch/getnlsubscriberform/demo/8209042b1786e26c355d4aea1b8c7b79/someone@example.com
oder
GET https://api.verowa.ch/getnlsubscriberfrom/demo/8209042b1786e26c355d4aea1b8c7b79/9WleKh55zpKLWxjwNwvVjJeA

Server Antwort

 
{
    "nl_subs_id": 0,
    "nl_fields": [
        {
            "label": "Mail",
            "input_name": "email",
            "value": "",
            "required": "required"
        },
        {
            "label": "Vorname",
            "input_name": "firstname",
            "value": "",
            "required": ""
        },
        {
            "label": "Nachname",
            "input_name": "lastname",
            "value": "",
            "required": ""
        },
        {
            "label": "Strasse",
            "input_name": "address",
            "value": "",
            "required": ""
        },
        {
            "label": "PLZ",
            "input_name": "postcode",
            "value": "",
            "required": ""
        },
        {
            "label": "Ort",
            "input_name": "city",
            "value": "",
            "required": ""
        }
    ],
    "nl_target_lists": [
        {
            "public_name": "Anlässe 60plus",
            "input_name": "targetlists[]",
            "value": "6441",
            "checked": "false"
        },
        {
            "public_name": "Anlässe Altersinstitutionen",
            "input_name": "targetlists[]",
            "value": "6447",
            "checked": "false"
        },
        {
            "public_name": "Atelier und Kreatives",
            "input_name": "targetlists[]",
            "value": "6443",
            "checked": "false"
        },
        {
            "public_name": "Bildung und Kultur",
            "input_name": "targetlists[]",
            "value": "6442",
            "checked": "false"
        },
        {
            "public_name": "Essen und Begegnung",
            "input_name": "targetlists[]",
            "value": "6615",
            "checked": "false"
        },
        {
            "public_name": "Gottesdienste",
            "input_name": "targetlists[]",
            "value": "6440",
            "checked": "false"
        }
    ],
    "nl_interval": [
        {
            "public_name": "halbwöchentlich",
            "value": "HALF_WEEK",
            "selected": "false"
        },
        {
            "public_name": "wöchentlich",
            "value": "WEEK",
            "selected": "false"
        },
        {
            "public_name": "alle 14 Tage",
            "value": "2_WEEKS",
            "selected": "false"
        },
        {
            "public_name": "monatlich",
            "value": "MONTH",
            "selected": "false"
        },
        {
            "public_name": "vierteljährlich",
            "value": "QUARTER_YEAR",
            "selected": "false"
        }
    ]
}

Alternative Antwort
In einigen Fällen bekommen Sie von der API eine (Fehler-)Meldung zurück. Diese hat folgenden einfachen Aufbau:

{
    "message": "Unbekannte Newsletter-Registration. Bitte versuchen Sie es erneut."
}

Zurück