Close-up van een laptoptoetsenbord

API voor testmail

Je eigen domein onder nmail.nl, en een API die wacht tot de verificatiemail binnen is. Voor end-to-end tests die niet meer haperen op e-mail.

Foto: Sa'Adat-E-Zubaire, CC0

  1. Namespace

    Bijvoorbeeld acme.nmail.nl. Elk adres daaronder werkt meteen.

  2. API-sleutel

    Maak je aan in je account, stuur je mee als Bearer-token.

  3. Wachten

    Eén verzoek dat terugkomt zodra de mail er is, of na maximaal 25 seconden.

  4. Link of code

    Links en eenmalige codes staan al uitgepakt in het antwoord.

De abonnementen voor de API openen binnenkort. Wil je nu al meetesten? Mail ons op [email protected].

Zo werkt het

Met een Dev- of Team-abonnement krijg je een eigen namespace, bijvoorbeeld acme.nmail.nl. Alle mail naar [email protected] komt binnen in je account. Je hoeft adressen niet vooraf aan te maken: de inbox ontstaat bij de eerste mail. Adressen met een +tag zijn aparte inboxen, handig om testruns uit elkaar te houden.

Authenticatie

Maak een API-sleutel aan in je account en stuur hem mee als Bearer-token:

Authorization: Bearer <je-api-sleutel>

Limiet: 120 verzoeken per minuut per account.

Endpoints

VerzoekWat
GET /api/v1/namespacesJe namespaces.
GET /api/v1/messages?to=&since=&limit=Laatste berichten, optioneel per adres en vanaf een tijdstip (ISO 8601). Maximaal 100.
GET /api/v1/messages/wait?to=&since=&timeout=Wacht op het eerste bericht voor een adres na since. Geeft 200 met het bericht of 204 als er binnen timeout seconden (max. 25) niets kwam.
GET /api/v1/messages/{id}Volledig bericht met tekst, HTML, gevonden links en codes.
DELETE /api/v1/messages/{id}Bericht verwijderen.

Links en codes

Bij elk volledig bericht staan links (alle http(s)-links, in volgorde) en codes (losse getallen van 4 tot 8 cijfers, zonder datums, tijden of cijfers uit links). Zo pak je een verificatielink of eenmalige code zonder zelf HTML te parsen.

Voorbeeld: curl

START=$(date -u +%Y-%m-%dT%H:%M:%SZ)
# ... laat je app een mail sturen naar [email protected] ...
curl -s -H "Authorization: Bearer $TEMPMAIL_TOKEN" \
  "https://tempmail.nl/api/v1/messages/wait?to=signup%[email protected]&since=$START&timeout=20" \
  | jq -r '.data.codes[0]'

Voorbeeld: Playwright

const since = new Date().toISOString();
await page.fill('#email', '[email protected]');
await page.click('button[type=submit]');

const res = await fetch(`https://tempmail.nl/api/v1/messages/wait?to=${encodeURIComponent('[email protected]')}&since=${since}&timeout=20`, {
  headers: { Authorization: `Bearer ${process.env.TEMPMAIL_TOKEN}` },
});
if (res.status === 204) throw new Error('Geen mail ontvangen');
const { data } = await res.json();
await page.goto(data.links.find((l) => l.includes('/verify')));

Bewaartermijn en limieten

  • Berichten in namespaces blijven 7 dagen bewaard.
  • Dev: 1 namespace, 5.000 berichten per maand. Team: 5 namespaces, 50.000 berichten per maand.
  • Maximaal 10 MB per bericht, bijlagen tot 5 MB.
  • Alleen ontvangen. Er wordt nooit mail verstuurd vanaf deze adressen.