API voor ontwikkelaars

Gebruik de API om tijdelijke inboxen te maken, berichten te lezen en de geldigheid te verlengen. Snelheidslimiet per IP.

Inbox aanmaken

POST https://10genmail.com/api/inbox

Geen body. Geeft nieuw adres en lege berichtenlijst terug.

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 600,
  "messages": []
}

Limiet: 10 verzoeken/minuut/IP.

Inbox ophalen

GET https://10genmail.com/api/inbox?address=...

Query: address (URL-gecodeerde e-mail). Geeft inbox en berichten terug, of 404 als verlopen.

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 420,
  "messages": [
    {
      "id": "msg-...",
      "from": { "name": null, "email": "sender@example.com" },
      "subject": "Hello",
      "text": "...",
      "html": null,
      "date": "...",
      "timestamp": 1234567900000
    }
  ]
}

Limiet: 120 verzoeken/minuut/IP.

Inbox verlengen

POST https://10genmail.com/api/inbox/extend

Body: { "address": "..." }. Voegt 10 minuten toe, tot 30 minuten totaal vanaf aanmaak. Geeft bijgewerkte inbox terug.

Limiet: als get (120/min).