Guide de démarrage avec l'API DustMail

L'API DustMail vous permet d'automatiser la création de boîtes de réception temporaires et la réception d'e-mails. C'est idéal pour les tests automatisés, les pipelines CI/CD et le développement d'applications sécurisées. Ce guide présente tous les endpoints essentiels avec des exemples en cURL, Node.js et Python.

Authentification

Toutes les requêtes API nécessitent une clé API. Vous pouvez générer cette clé depuis votreTableau de bord et la transmettre dans l'en-tête Authorization:

Authorization: Bearer dm_live_your_api_key

Créer une boîte de réception

Envoyez une requête POST pour créer une nouvelle adresse e-mail temporaire :

POST https://dustmail.net/api/v1/inbox

Exemple avec cURL

curl -X POST https://dustmail.net/api/v1/inbox \
  -H "Authorization: Bearer dm_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"duration": 30}'

Vérifier les e-mails (Polling)

Après avoir créé la boîte de réception, interrogez l'API pour vérifier l'arrivée de nouveaux messages :

GET https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID

Limites de requêtes (Rate Limits)

Les comptes gratuits sont limités à 100 appels API par jour. Les comptes Premium bénéficient d'un accès API illimité – passez à l'offre Premium sur la page des Tarifs.

Cas d'utilisation

• Tests E2E - Créez des boîtes dans vos suites de tests pour valider les inscriptions
• Pipelines CI/CD - Automatisez la vérification d'e-mails dans vos pipelines de déploiement
• Applications de confidentialité - Intégrez des e-mails jetables directement dans votre produit