Je eerste API-aanroep doen

De snelste manier om te zien of alles werkt, is het opvragen van je lijsten. Die aanroep verandert niets aan je account en geeft meteen antwoord. Je kunt deze aanroep hier op de site doen of vanaf je eigen computer.

Aanroep doen via deze site

Aanroep doen vanaf je eigen systeem

Hoe je je sleutel meestuurt, lees je bij Authenticatie met je API-sleutel.

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

Met de PHP-bibliotheek is dat:

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

Een antwoord ziet er zo uit, ingekort tot één lijst:

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

Een relatie toevoegen

De aanroep die je daarna waarschijnlijk nodig hebt, is het toevoegen van een relatie. Naast het e-mailadres is het IP-adres verplicht, want daarmee leg je vast waar de aanmelding vandaan kwam.

curl https://api.laposta.nl/v2/member \
  -u JOUW_API_SLEUTEL: \
  -d list_id=BaImMu3JZA \
  -d ip=198.51.100.10 \
  -d email=nieuwe.relatie@example.net \
  -d custom_fields[voornaam]=Sanne

$laposta->memberApi()->create('BaImMu3JZA', [
    'ip' => '198.51.100.10',
    'email' => 'nieuwe.relatie@example.net',
    'custom_fields' => ['voornaam' => 'Sanne'],
]);

De sleutels binnen custom_fields zijn de custom_name van je eigen velden. Die kun je eenmalig ophalen met Alle velden opvragen en in je eigen code bewaren.

Gerelateerde artikelen