API

REST-API-Referenz

Alle Endpunkte, Parameter, Beispiel-Anfragen und -Antworten. Authentifizierung: API-Schlüssel (Bearer).

Schnelles Beispiel

curl https://api.sendnomi.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Willkommen",
    "html": "<h1>Hallo!</h1>"
  }'

Der API-Schlüssel wird im Panel → Tab Entwickler abgerufen. Separate Schlüssel für Produktions- und Testumgebung.

Endpunkt-Liste

  • POST /v1/messages Einzelne oder Massen-E-Mail senden.
  • GET /v1/messages/{id} Status einer bestimmten Nachricht abfragen.
  • GET /v1/messages Nachrichtenliste, mit Filterung und Paginierung.
  • POST /v1/templates Neue Vorlage erstellen (Handlebars + Liquid Mix).
  • GET /v1/templates/{id} Vorlagen-Detail.
  • POST /v1/suppressions Adresse zur Suppression-Liste hinzufügen.
  • GET /v1/suppressions Suppression-Liste.
  • POST /v1/webhooks Webhook-Endpunkt registrieren.
  • GET /v1/events Ereignis-Stream (sent, delivered, opened, clicked, bounced, complained).
  • GET /v1/domains Ihre verifizierten Domains.

Bald. Ein Try-It-Out-Panel für jeden Endpunkt (mit cURL · JS · Python Tabs).