API-Referenz
Die REST-API von Skrybo
Eine Basis-URL, ein Bearer-Token, sieben Endpunkte. Dasselbe Format POST /v1/emails wie bei Resend — für die Migration genügt eine geänderte Basis-URL. Die ausführliche Dokumentation liegt unter /docs.
Eine Nachricht senden
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>",
)EndpunkteAlles unter
Alles unter /v1
| Methode | Pfad | Zweck |
|---|---|---|
POST | /v1/emails | Eine einzelne transaktionale E-Mail senden (zu Resend kompatibles Format). |
POST | /v1/emails/batch | Bis zu 100 Nachrichten in einer Anfrage senden. Gleiches Format. |
GET | /v1/emails/:id | Zustellstatus, Öffnungen, Klicks und Unzustellbarkeiten abrufen. |
GET | /v1/audiences | Zielgruppen des Kontos auflisten. |
POST | /v1/audiences | Eine neue Zielgruppe für Kampagnen anlegen. |
POST | /v1/audiences/:audienceId/contacts | Einen Kontakt zu einer Zielgruppe hinzufügen. |
GET | /v1/audiences/:audienceId/contacts | Kontakte einer Zielgruppe auflisten. |
GET | /v1/suppressions | Sperrlisteneinträge mit Grund und created_at auflisten. |
POST | /v1/suppressions | Eine Adresse zu Ihrer Sperrliste hinzufügen. |
SMTP-Relay
Standard-SMTP, Standardports
- Host:
smtp.skrybo.com - Port: 587 (STARTTLS) oder 465 (implizites TLS)
- Benutzername:
apikey - Passwort:
skrybo_live_…— Ihr Entwickler-API-Schlüssel
Webhook-Ereignisse
Standard Webhooks, HMAC-SHA256
| Ereignis | Wann es ausgelöst wird |
|---|---|
email.sent | Nachricht vom Relay angenommen. |
email.delivered | Der MTA des Empfängers hat die Zustellung bestätigt. |
email.bounced | Endgültig unzustellbar (Adresse gesperrt). |
email.complained | Der Empfänger hat die Nachricht als Spam gemeldet. |
email.opened | Das Zählpixel wurde geladen. |
email.clicked | Ein umgeschriebener Link wurde geöffnet. |