GetTempInbox
100% Éphémère & Anonyme
Retour à la boîte de réception
API REST v1 • CORS Ouvert • Sans Clé Requise

Documentation API pour Développeurs & QA

Automatisez vos suites de tests Playwright, Cypress, ou vos pipelines CI/CD. Récupérez les codes de confirmation et les emails entrants directement en JSON sans configurer de serveur IMAP/SMTP.

Adresse de base de l'API
https://gettempinbox.com/api/v1
Réponse JSON en < 50ms
Headers CORS autorisés (*)
Aucune inscription requise
GET/api/v1/inbox/:email/otp

Renvoie directement le dernier code de confirmation (OTP) extrait de l'email pour cette adresse. Si aucun email ou aucun code n'est encore arrivé, l'endpoint renvoie un code HTTP 404 avec le statut "waiting".

Exemple cURL :
curl -s "https://gettempinbox.com/api/v1/inbox/test@catsdaily.world/otp"
Réponse JSON (200 OK) :
{
  "email": "test@catsdaily.world",
  "otp": "739102",
  "subject": "Votre code de validation",
  "from": "support@service.com",
  "receivedAt": "2026-09-24T00:00:00.000Z"
}
GET/api/v1/inbox/:email/latest

Renvoie l'intégralité du dernier email reçu au format JSON structuré (sujet, expéditeur, corps HTML désinfecté, texte brut et code OTP).

Exemple cURL :
curl -s "https://gettempinbox.com/api/v1/inbox/test@catsdaily.world/latest"

Intégration Playwright (Test E2E)

Copiez ce helper directement dans vos tests d'onboarding pour attendre et injecter le code OTP dans votre formulaire :

import { test, expect } from '@playwright/test';

// Fonction helper pour récupérer l'OTP
async function waitForOtp(email: string, timeoutSec = 30): Promise<string> {
  const start = Date.now();
  while (Date.now() - start < timeoutSec * 1000) {
    const res = await fetch(`https://gettempinbox.com/api/v1/inbox/${encodeURIComponent(email)}/otp`);
    if (res.ok) {
      const data = await res.json();
      return data.otp;
    }
    await new Promise((r) => setTimeout(r, 2000)); // Polling toutes les 2s
  }
  throw new Error("Timeout en attendant le code OTP");
}

test("Inscription et vérification automatique", async ({ page }) => {
  const tempEmail = `test-${Date.now()}@catsdaily.world`;

  await page.goto('https://votre-site.com/signup');
  await page.fill('input[type="email"]', tempEmail);
  await page.click('button[type="submit"]');

  // Attente automatique du code OTP reçu sur TempMail
  const otpCode = await waitForOtp(tempEmail);

  // Remplissage du code dans l'interface
  await page.fill('input[name="otp"]', otpCode);
  await page.click('button#confirm');

  await expect(page.locator('text=Bienvenue')).toBeVisible();
});

Webhooks Outbound (Discord / Slack)

Vous pouvez configurer un webhook pour recevoir une notification instantanée dès qu'un email arrive. Renseignez votre webhook directement via le bouton "Dev Tools" de la boîte de réception ou par API :

curl -X POST "https://gettempinbox.com/api/inbox/test@catsdaily.world/webhook" \
  -H "Content-Type: application/json" \
  -d '{"webhookUrl": "https://discord.com/api/webhooks/VOTRE_WEBHOOK"}'

Prêt à tester l'API en direct ?

Générez une adresse temporaire dès maintenant et lancez vos requêtes cURL.

Ouvrir la boîte de réception