Descripción general de la API
La REST API de EvilMail proporciona acceso programático completo a todas las funciones del servicio. Puedes crear bandejas de entrada temporales, leer y eliminar mensajes y gestionar dominios personalizados, todo a través de simples solicitudes HTTP.
Autenticación
Todas las solicitudes a la API requieren una clave de acceso válida. Puedes obtener tu clave desde el panel de control de EvilMail. Envía la clave en el encabezado de cada solicitud:
curl -H "Authorization: Bearer YOUR_API_KEY"
https://api.evilmail.com/v1/inboxesCrear una bandeja de entrada temporal
Para crear una nueva bandeja de entrada, envía una solicitud POST:
curl -X POST https://api.evilmail.com/v1/inboxes
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"domain": "yourdomain.com", "prefix": "test"}'La respuesta incluye la dirección de correo electrónico creada y el identificador de la bandeja de entrada que usarás en las solicitudes posteriores.
Leer mensajes
Para recuperar los mensajes entrantes de una bandeja de entrada específica:
curl https://api.evilmail.com/v1/inboxes/{inbox_id}/messages
-H "Authorization: Bearer YOUR_API_KEY"La respuesta devuelve una lista de mensajes que incluye el remitente, el asunto, el contenido de texto, el contenido HTML y los archivos adjuntos.
Webhooks para notificaciones instantáneas
En lugar de consultar repetidamente en busca de nuevos mensajes, puedes registrar una URL de Webhook para recibir una notificación instantánea cuando llegue un nuevo mensaje:
curl -X POST https://api.evilmail.com/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"inbox_id": "abc123", "url": "https://yourapp.com/webhook/email"}'Límites de uso y manejo de errores
La API está sujeta a límites de uso que dependen de tu plan de suscripción. Las respuestas incluyen los encabezados X-RateLimit-Remaining y X-RateLimit-Reset para ayudarte a gestionar las solicitudes. Si superas el límite, recibirás una respuesta con el código 429 Too Many Requests. Asegúrate de implementar lógica de reintentos con retroceso exponencial en tu aplicación.