Guía de inicio con la API de DustMail
La API de DustMail te permite automatizar la creación de bandejas de entrada de correo temporal y la recepción de correos. Esto es perfecto para pruebas automatizadas, flujos de integración CI/CD y desarrollo de aplicaciones seguras. Esta guía cubre todos los endpoints clave con ejemplos prácticos en cURL, Node.js y Python para comenzar en menos de 5 minutos.
Autenticación
Todas las solicitudes de la API requieren una clave API. Puedes generar esta clave desde tuPanel de control, luego pásala a través del encabezado Authorization:
Authorization: Bearer dm_live_your_api_key
Crear una bandeja de entrada
Envía una solicitud POST para crear una nueva dirección de correo temporal:
POST https://dustmail.net/api/v1/inbox
Ejemplo con cURL
curl -X POST https://dustmail.net/api/v1/inbox \ -H "Authorization: Bearer dm_live_xxx" \ -H "Content-Type: application/json" \ -d '{"duration": 30}'
Consultar nuevos correos (Polling)
Después de crear la bandeja de entrada, realiza llamadas a la API para verificar si han llegado nuevos correos:
GET https://dustmail.net/api/v1/inbox/YOUR_INBOX_ID
Límites de llamadas (Rate Limits)
Las cuentas gratuitas reciben hasta 100 llamadas API al día, lo cual es suficiente para pruebas básicas. Las cuentas Premium obtienen llamadas API ilimitadas – actualiza en la página de Precios.
Casos de uso
- Pruebas E2E - Crea bandejas de entrada en suites de pruebas para verificar flujos de registro
- Pipelines CI/CD - Automatiza la verificación de correos en flujos de despliegue
- Aplicaciones de Privacidad - Integra correo desechable directamente en tu producto