Integraties

REST API

De Wesender API is een HTTP REST-API waarmee je e-mails verstuurt, domeinen beheert en statistieken ophaalt. Alle verzoeken verlopen via https://api.wesender.nl en geven JSON terug.

Authenticatie

Elk verzoek vereist een API-sleutel in de Authorization header als Bearer-token. Maak een sleutel aan via Dashboard › API Keys. 

Authorization: Bearer ws_live_xxxxxxxxxxxxxxxxxxxx

Bewaar API-sleutels als omgevingsvariabele (WS_API_KEY), nooit hardcoded in je broncode.

Base URL

https://api.wesender.nl

Alle endpoints zijn relatief aan deze base URL. Gebruik altijd HTTPS.

Eerste verzoek

Stuur je eerste e-mail met curl:

curl https://api.wesender.nl/emails \
  -H "Authorization: Bearer ws_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Jouw Bedrijf <noreply@jouwdomein.nl>",
    "to": ["ontvanger@voorbeeld.nl"],
    "subject": "Hallo!",
    "html": "<p>Dit is een testbericht via de Wesender API.</p>"
  }'

Bij succes ontvang je een 201 met het e-mail-ID:

{
  "id": "em_01j9xk2r4f5g6h7j8k9l0m1n2o"
}

Foutcodes

Status Betekenis
200 / 201 Verzoek geslaagd
400 Ongeldige invoer - controleer de request body
401 Ontbrekende of ongeldige API-sleutel
403 Afzenderdomein niet geverifieerd
422 Validatiefout - veld ontbreekt of heeft verkeerd formaat
429 Rate limit bereikt - wacht even en probeer opnieuw
500 Serverfout aan onze kant - probeer opnieuw of neem contact op

Rate limits

De API heeft geen vaste rate limit per seconde, maar stelt grenzen op basis van je abonnement. Bij een 429-respons bevat de header Retry-After het aantal seconden dat je moet wachten.

Endpoints