API REST
Tu buzón, por HTTP puro.
Envía, lee y gestiona el correo desde tu propio código. Cada clave tiene solo los alcances que le concedes.
En resumen
¿Qué es una API de correo?
Una API de correo permite que el software envíe y lea correo por HTTP, no a través de una app. Una clave en cada solicitud decide qué puede tocar quien llama.
104
operaciones documentadas
25
dominios enteros de envío por clave
50
direcciones sueltas, además de esos
Cómo funciona
Acota cada clave a una tarea
Elige los alcances de una clave y, si quieres, los remitentes que puede usar. Un alcance que falta o un remitente fuera de la lista recibe un 403.
Reintenta sin enviar dos veces
Cada envío recibe su id msg_ antes de que salga nada. Un reintento con la misma Idempotency-Key devuelve el primer resultado.
Rota el secreto, conserva la clave
Rotar cambia solo el secreto, así que el id, los alcances y el historial de solicitudes siguen. Una clave revocada recibe revoked_api_key.
Alcances de una clave
Treinta en total. Las claves nuevas empiezan con emails:send.
Envía tu primer correo
HTTP y JSON sin más. Nada que instalar.
curl -X POST https://api.openemail.uk/emails \ -H "Authorization: Bearer $OPENEMAIL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "from": "Acme Billing <[email protected]>", "to": ["[email protected]"], "subject": "Your September invoice", "html": "<p>Invoice attached.</p>" }'Lo que obtienes
Ya en el producto
Cada envío tiene un id
/events por destinatario, /tracking para aperturas y clics.
Un 403, explicado
GET /ping muestra los alcances de la clave y lo que le dejó su rol.
Claves por MCP
El servidor MCP también lista, rota, revoca y activa claves.
Buenas prácticas
Sácale el máximo partido
- 01
Una clave por servicio
Así, revocar una clave filtrada detiene una integración, no todas.
- 02
Pon una Idempotency-Key
Derívala de algo único, como un número de factura, para que un reintento repita el primer resultado.
- 03
Acota el remitente
Lista solo las direcciones desde las que envía un servicio. Un dominio entero cubre las que se añadan después.
En qué punto está
Conviene saber
- Sin endpoint de subida
- Los adjuntos en línea van en base64, 5 MB en total. Los archivos mayores van por id de archivo del espacio de trabajo, como enlace de descarga.
- Sin estado de rebote en un envío
- GET /emails muestra un mensaje rebotado como enviado. El rebote aparece en su destinatario y en un webhook email.bounced.
Preguntas
Lo que más nos preguntan
Sigue explorando
Combina bien con
Empieza
Tu dominio,
tu correo.
Apunta un dominio a OpenEmail y lee su correo en un buzón hecho a su medida. El plan gratuito incluye un dominio.
