Una API de email que funciona con el cliente HTTP que ya tienes.
Sin SDK que instalar: con curl, fetch o requests basta. Un esquema OpenAPI, errores estructurados y un modo de prueba hacen predecible todo lo demás.
- Sin tarjeta para probar
- Precios en euros, sin IVA
curl -X POST https://api.outstamp.dev/v1/emails \
-H "Authorization: Bearer $OUTSTAMP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: welcome-42" \
-d '{
"from": "Acme <[email protected]>",
"to": "[email protected]",
"subject": "Te damos la bienvenida a Acme",
"html": "<p>Tu cuenta está lista.</p>"
}'const response = await fetch("https://api.outstamp.dev/v1/emails", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.OUTSTAMP_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `welcome-${user.id}`
},
body: JSON.stringify({
from: "Acme <[email protected]>",
to: "[email protected]",
subject: "Te damos la bienvenida a Acme",
html: "<p>Tu cuenta está lista.</p>"
})
});
const email = await response.json(); // 202, { id, status: queued }import os, requests
response = requests.post(
"https://api.outstamp.dev/v1/emails",
headers={
"Authorization": f"Bearer {os.environ['OUTSTAMP_API_KEY']}",
"Idempotency-Key": f"welcome-{user.id}",
},
json={
"from": "Acme <[email protected]>",
"to": "[email protected]",
"subject": "Te damos la bienvenida a Acme",
"html": "<p>Tu cuenta está lista.</p>",
},
)
email = response.json() # 202, { id, status: queued }Hecha para tu forma de trabajar.
Errores con los que puedes actuar
Cada error tiene un
type, uncodeestable, elparameterque falla, unrequest_idy si esretryable.Un esquema OpenAPI
Un único esquema canónico describe cada endpoint, campo y error, para tu generador de clientes o tus tests.
Docs que tu agente de código puede leer
llms.txt y llms-full.txt dan a las herramientas de IA para programar toda la documentación en una sola petición.
Claves de prueba con resultados conocidos
Las claves
os_test_y las direcciones del simulador permiten que tus tests comprueben rebotes y quejas, no solo el camino feliz.
Cuándo puedes querer otra cosa.
Preferimos que elijas bien a que cambies dos veces.
- Quieres hoy un SDK tipado en tu lenguaje. Outstamp aún no tiene ninguno, aunque el esquema OpenAPI puede generar uno.
- Tu stack solo habla SMTP. Outstamp todavía no tiene relay SMTP.
De la clave al primer email.
- 1
Copia una clave de prueba
Créala en el panel y guárdala en las variables de entorno de tu servidor.
- 2
Haz una petición
POST /v1/emailscon from, to, subject y html. Recibes202y un id. - 3
Lee los eventos
GET /v1/emails/{id}/events, o suscribe un endpoint de webhook.
Preguntas de desarrolladores.
¿Qué lenguajes puedo usar?
Cualquier lenguaje que pueda hacer una petición HTTPS. La documentación muestra curl, Node.js y Python.
¿Hay límite de peticiones?
Sí, por proyecto, y crece a medida que se acumula tu historial de envíos. Los límites y sus códigos de error están en Límites y errores.
¿Cómo sé qué ha fallado en una petición?
Registra el request_id del error. Relaciona la petición con el email en tu panel.
Haz tu primera petición en modo de prueba.
Sin tarjeta, sin DNS y sin SDK.
- Sin tarjeta para probar
- Precios en euros, sin IVA