Documentación
Tres endpoints y ninguna cuenta. No hay mucho que aprender, así que no hay mucho que leer.
Empieza aquí
Guía rápida
Un buzón funcional y un mensaje leído de vuelta, en cuatro comandos. Empieza aquí si nunca has llamado a la API.
Referencia de la API
Los tres endpoints con parámetros, ejemplos y códigos de estado. El contrato, completo.
Límites
Límite de solicitudes, tamaño de mensaje, retención y todo lo demás que tiene un tope. Página corta, sin sorpresas.
Guías
Recorridos más largos, con los modos de fallo incluidos: qué hacer, no qué significa un parámetro.
Cuánto dura un buzón
A qué se aplica la ventana de 5 días y a qué no, cuándo empieza realmente el reloj, todo lo que desaparece junto con un mensaje, cómo leer el plazo directamente desde la API, y el hábito que hace que nada de esto importe.
Qué es el correo temporal
La definición, la mecánica (un registro MX y un buzón que existe en cuanto llega el primer mensaje), correo temporal frente a desechable, burner y alias, para qué sirve, los cuatro casos en que es la herramienta equivocada y cuánto dura una dirección.
Pruebas de email en Playwright
Una fixture que abre un buzón nuevo por test, una espera con plazo de reloj en lugar de un contador de reintentos, extractores anclados en tu propia plantilla, tres flujos completos (código, enlace mágico, restablecimiento) y cómo sobrevive en CI sin secretos.
Las cuatro cosas que vale la pena saber
- No se crea un buzón
- No hay una llamada para «crear dirección». Una dirección existe en el momento en que llega correo a ella, y deja de existir cuando expira el último mensaje.
- La dirección es la credencial
- En un dominio público, quien conozca la dirección puede leerla — igual por la API que por el sitio. Usa tu propio dominio cuando eso no sea aceptable.
- Todo caduca
- Los mensajes se eliminan 5 días después de llegar.
expires_atfigura en cada mensaje para que nunca tengas que calcularlo. - Solo recepción
- Ningún endpoint envía correo. Es deliberado: es lo que evita que un servicio gratuito y sin autenticación se convierta en un relé de spam.
Cuando algo va mal
Si una llamada se comporta de forma distinta a esta documentación, el error está en la documentación: avísanos y se corrige.
- El correo nunca llega
- Comprueba primero el registro MX:
smtp.grabmail.ioy nada más. Un MX que quedó de un proveedor anterior se lleva parte de tu tráfico en silencio. - La API responde 404
- O el dominio no apunta aquí, o el mensaje pasó su ventana de retención. Los dos casos se distinguen por el slug
error. - El correo dice venir de nosotros
- Está falsificado. Nada aquí puede enviar correo: nuestro SPF es
v=spf1 -ally nuestro DMARC esp=reject, lo que indica a todo servidor receptor del mundo que lo descarte.