Zur Navigation springen

Ihren ersten API-Aufruf durchführen

Der schnellste Weg um zu prüfen, ob alles funktioniert, ist das Abrufen Ihrer Listen. Dieser Aufruf verändert nichts an Ihrem Konto und liefert sofort eine Antwort. Sie können diesen Aufruf direkt hier auf der Website oder von Ihrem eigenen Computer aus durchführen.

Aufruf über diese Website durchführen

1

Erstellen Sie einen API-Schlüssel

Erstellen Sie in Ihrem Konto unter „Verbindungen“ einen Schlüssel. Ein neuer Schlüssel wird nur ein einziges Mal angezeigt, speichern Sie ihn also sofort ab. Siehe: API-Schlüssel erstellen.

2

Öffnen Sie den Endpoint

Gehen Sie zu Alle Listen abrufen.

3

Geben Sie Ihren Schlüssel ein und senden Sie ihn ab

Klicken Sie rechts beim Codebeispiel auf „Try it“ und tragen Sie Ihren Schlüssel bei „api_key“ ein. Klicken Sie danach auf Senden. Mehr über dieses Feld und diese Schaltfläche lesen Sie unter API mit Try it ausprobieren.

4

Lesen Sie die Antwort

Sie erhalten eine 200-Antwort mit all Ihren Listen in data. Die list_id, die Sie dort sehen, benötigen Sie bei fast jedem anderen Aufruf.

Sie führen hiermit einen echten Aufruf durch. Wie Sie sicher testen, erfahren Sie unter API mit Try it ausprobieren.

Aufruf von Ihrem eigenen System aus durchführen

Wie Sie Ihren Schlüssel mitsenden, lesen Sie unter Authentifizierung mit Ihrem API-Schlüssel.

curl
curl https://api.laposta.nl/v2/list \
-u IHR_API_SCHLUESSEL:

Mit der PHP-Bibliothek sieht das so aus:

PHP
$laposta = new Laposta('IHR_API_SCHLUESSEL');
$lijsten = $laposta->listApi()->all();

Eine Antwort sieht so aus, hier gekürzt auf eine Liste:

{
"data": [
{
"list": {
"list_id": "BaImMu3JZA",
"name": "Newsletter",
"state": "active",
"members": { "active": 1232, "unsubscribed": 113, "cleaned": 14 }
}
}
]
}

Einen Abonnenten hinzufügen

Der Aufruf, den Sie danach wahrscheinlich benötigen, ist das Hinzufügen eines Abonnenten. Neben der E-Mail-Adresse ist auch die IP-Adresse erforderlich, da Sie damit festhalten, woher die Anmeldung stammt.

curl
curl https://api.laposta.nl/v2/member \
-u IHR_API_SCHLUESSEL: \
-d list_id=BaImMu3JZA \
-d ip=198.51.100.10 \
-d email=neuer.abonnent@example.net \
-d custom_fields[voornaam]=Sanne
PHP
$laposta->memberApi()->create('BaImMu3JZA', [
'ip' => '198.51.100.10',
'email' => 'neuer.abonnent@example.net',
'custom_fields' => ['voornaam' => 'Sanne'],
]);

Die Schlüssel innerhalb von custom_fields sind die custom_name Ihrer eigenen Felder. Diese können Sie einmalig über Alle Felder abrufen abrufen und in Ihrem eigenen Code speichern.

Verwandte Artikel