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.
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.