Referencia de la API
La API REST de Skrybo
Una URL base, un token bearer, siete endpoints. El mismo formato POST /v1/emails que Resend: para migrar basta con cambiar la URL base. La documentación completa vive en /docs.
Enviar un mensaje
POST /v1/emails
curl
curl -X POST https://api.skrybo.com/v1/emails \
-H "Authorization: Bearer skrybo_live_xxx" \
-H "Content-Type: application/json" \
-d '{"from":"you@your-domain.com","to":["a@b.com"],"subject":"Hi","html":"<p>Hi</p>"}'JavaScript
import { Skrybo } from "skrybo";
const s = new Skrybo(process.env.SKRYBO_API_KEY);
await s.emails.send({
from: "you@your-domain.com",
to: ["a@b.com"],
subject: "Hi",
html: "<p>Hi</p>",
});Python
from skrybo import Skrybo
s = Skrybo(api_key=os.environ["SKRYBO_API_KEY"])
s.emails.send(
from_="you@your-domain.com",
to=["a@b.com"],
subject="Hi",
html="<p>Hi</p>",
)EndpointsTodo lo que hay bajo
Todo lo que hay bajo /v1
| Método | Ruta | Función |
|---|---|---|
POST | /v1/emails | Enviar un correo transaccional (formato compatible con Resend). |
POST | /v1/emails/batch | Enviar hasta 100 mensajes en una petición. Mismo formato. |
GET | /v1/emails/:id | Consultar el estado de entrega, aperturas, clics y rebotes. |
GET | /v1/audiences | Listar las audiencias de la cuenta. |
POST | /v1/audiences | Crear una audiencia para campañas. |
POST | /v1/audiences/:audienceId/contacts | Añadir un contacto a una audiencia. |
GET | /v1/audiences/:audienceId/contacts | Listar los contactos de una audiencia. |
GET | /v1/suppressions | Listar las supresiones con su motivo y created_at. |
POST | /v1/suppressions | Añadir una dirección a tu lista de supresiones. |
Relé SMTP
SMTP estándar, puertos estándar
- Host:
smtp.skrybo.com - Puerto: 587 (STARTTLS) o 465 (TLS implícito)
- Usuario:
apikey - Contraseña:
skrybo_live_…— tu clave de API para desarrolladores
Eventos de webhook
Standard Webhooks, HMAC-SHA256
| Evento | Cuándo se dispara |
|---|---|
email.sent | El relé aceptó el mensaje. |
email.delivered | El MTA del destinatario confirmó la entrega. |
email.bounced | Rebote definitivo (dirección suprimida). |
email.complained | El destinatario lo marcó como spam. |
email.opened | Se cargó el píxel de seguimiento. |
email.clicked | Se siguió un enlace reescrito. |