API pour les développeurs

Utilisez l'API pour créer des boîtes temporaires, lire les messages et prolonger l'expiration. Limite de débit par IP.

Créer une boîte

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

Aucun body. Retourne une nouvelle adresse et une liste de messages vide.

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

Limite : 10 requêtes/minute/IP.

Récupérer la boîte

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

Query : address (e-mail encodé en URL). Retourne la boîte et les messages, ou 404 si expiré.

{
  "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
    }
  ]
}

Limite : 120 requêtes/minute/IP.

Prolonger la boîte

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

Body : { "address": "..." }. Ajoute 10 minutes, jusqu'à 30 au total depuis la création. Retourne la boîte mise à jour.

Limite : comme get (120/min).