getnlsubscriberfrom

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 zu machen, ohne, wie bisher, einen iFrame einzubinden. Das Array kann dann 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 Felder dann an die API zu verschicken, benutzen Sie bitte die Methode updatenlsubscriber. Achtung: Sie brauchen für den Aufbau des Formulars ausserdem Buttons in Ihrem Formular, diese werden nicht von der API geliefert.

Resource URL
https://api.verowa.ch/geteventdetails/:instance/:apikey/:id/

Parameter
– Ihr Instanzname :instance
– Ihr API-Key :apikey
– E-Mail-Adresse oder Subscriber Key (wird von Verowa internen Malings geliefert) Die Funktion entscheidet selbständig was eingetragen wurde.

Beispielanfrage
GET https://api.verowa.ch/getnlsubscriberfrom/demo/8209042b1786e26c355d4aea1b8c7b79/someemail@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."
}