# Entwicklerübersicht

> Basis-URL, Authentifizierung, Objekt-IDs, Fehler, Paginierung, Rate Limits, SDKs, Webhooks und MCP. Die Konventionen, die alle Emailit-Integrationen gemeinsam haben.

Diese Seite fasst die Konventionen zusammen, die Sie kennen sollten, bevor Sie Code für Emailit schreiben: wo die API liegt, wie Anfragen authentifiziert werden, wie Objekte identifiziert werden und wie Fehler, Paginierung und Rate Limits funktionieren. Jeder Abschnitt verweist auf die ausführliche Referenz.

## Integrationsmöglichkeiten

| Schnittstelle | Endpunkt | Geeignet für |
| --- | --- | --- |
| REST-API | `https://api.emailit.com/v2` | E-Mails senden und alle Ressourcen per Code verwalten. |
| SMTP-Relay | `smtp.emailit.com` | Apps, Frameworks und CMS, die bereits SMTP sprechen. Siehe [SMTP-Einstellungen](/de/docs/smtp/settings/). |
| Webhooks | Ihr HTTPS-Endpunkt | Events zu Zustellung, Engagement und Ressourcen in Echtzeit. |
| MCP-Server | `https://api.emailit.com/mcp` | KI-Assistenten wie Claude, ChatGPT und Cursor mit Ihrem Workspace arbeiten lassen. |
| OAuth 2.1 | `https://api.emailit.com/oauth/*` | Integrationen, die im Namen von Emailit-Nutzern handeln, ohne deren API-Schlüssel zu verwalten. |

Sie sind unsicher, ob Sie die API oder SMTP verwenden sollen? Lesen Sie [API oder SMTP](/de/docs/get-started/api-or-smtp/).

## Basis-URL und Versionierung

Alle REST-Endpunkte liegen unter einer Basis-URL:

```text
https://api.emailit.com/v2
```

`v2` ist die aktuelle und einzige dokumentierte Version. Die alte API `v1` ist veraltet; siehe [Versionierung](/de/docs/api-reference/versioning/).

## Authentifizierung

Senden Sie bei jeder Anfrage einen API-Schlüssel als Bearer-Token im Header `Authorization`:

```bash
curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

- API-Schlüssel beginnen mit `secret_`. Ältere Schlüssel ohne das Präfix funktionieren weiterhin.
- Jeder Schlüssel gehört zu einem Workspace und hat einen Scope: **Full Access** (`full`) kann jeden Endpunkt aufrufen, **Sending Only** (`sending`) kann nur senden und Sendungen verwalten. Siehe [API-Schlüssel](/de/docs/developers/api-keys/).
- OAuth-Zugriffstokens, die an [OAuth-Apps](/de/docs/developers/oauth-apps/) ausgegeben wurden, werden im selben Header akzeptiert.
- Ein fehlender Schlüssel gibt `401` mit `API key required` zurück, ein unbekannter Schlüssel `401` mit `Invalid API key` und ein gesperrter Workspace `403` mit `Workspace is suspended`.

Rufen Sie die API nie mit Ihrem Schlüssel aus einem Browser oder einer mobilen App auf. Behalten Sie ihn auf Ihrem Server. Details: [Authentifizierung](/de/docs/api-reference/authentication/).

## IDs und Präfixe

Jedes Objekt hat eine String-ID mit einem Typpräfix, sodass Sie auf einen Blick erkennen, worauf sich eine ID bezieht.

| Objekt | Präfix | Beispiel |
| --- | --- | --- |
| E-Mail | `em_` | `em_4K6oASS7KP9ztzWmSN9ndEu13HW` |
| Versanddomain | `dom_` | `dom_3xQ7mLp2RkT9vB4nHs8YcWd1Ze6` |
| API-Schlüssel | `key_` | `key_4F2kN8sQwE1rT6yU3iO9pA7sD5f` |
| Kontaktliste | `aud_` | `aud_3zR8tY2uI6oP4aS1dF9gH7jK5lM` |
| Abonnent | `sub_` | `sub_4K6oASS7KP9ztzWnqS4svxApJzO` |
| Kontakt | `con_` | `con_4A9sD2fG6hJ1kL8zX3cV7bN5mQw` |
| Vorlage | `tem_` | `tem_3wE8rT1yU5iO9pA2sD6fG4hJ7kL` |
| Sperrung | `sup_` | `sup_4K6oASS7KP9ztzWol5ElicOeKFE` |
| Webhook | `wh_` | `wh_3mN7bV2cX6zL9kJ4hG1fD8sA5pO` |
| Webhook-Anfrage | `whr_` | `whr_4K6oASS7KP9ztzWpVUIec9Jneax` |
| Event | `evt_` | `evt_4K6oASS7KP9ztzWpqId2iIptac5` |
| Kampagne | `cmp_` | `cmp_4B1nM5qW9eR3tY7uI2oP6aS8dF4` |
| Formular | `frm_` | `frm_4C3vB7nM1qW5eR9tY2uI6oP8aS4` |
| Formulareinsendung | `fsub_` | `fsub_4K6oASS7KP9ztzWqvxLV3IsFRs8` |
| Automatisierung | `aut_` | `aut_4D5fG9hJ3kL7zX1cV6bN2mQ8wE4` |
| Automatisierungsdurchlauf | `aur_` | `aur_4K6oASS7KP9ztzWrWOjGgqompRo` |
| E-Mail-Verifizierung | `ev_` | `ev_4E7gH1jK5lZ9xC3vB8nM2qW6eR4` |
| Verifizierungsliste | `evl_` | `evl_4F9hJ3kL7zX1cV5bN9mQ2wE6rT8` |
| DMARC-Bericht | `dmr_` | `dmr_4K6oASS7KP9ztzWsW7e5qkOYHO6` |

Domains, die vor der Umstellung auf `dom_`-IDs erstellt wurden, können noch IDs mit `sd_` oder `sed_` haben.

Einige Endpunkte akzeptieren statt der ID auch eine lesbare Kennung: einen Namen bei API-Schlüsseln, Domains, Webhooks, Kampagnen und Kontaktlisten und eine E-Mail-Adresse bei Kontakten und Sperrungen. E-Mails, Vorlagen und Events werden nur per ID gefunden.

## Anfragen und Antworten

- **JSON rein, JSON raus.** Senden Sie Anfrage-Bodys als JSON mit `Content-Type: application/json`. Fehlerhaftes JSON gibt `400` mit `Invalid JSON in request body` zurück. Ein Anfrage-Body darf bis zu 50 MB groß sein, die endgültige MIME-Nachricht einer E-Mail bis zu 40 MB.
- **Fehler.** Die meisten Fehler geben `{"statusCode", "error", "message"}` zurück. Validierungsfehler enthalten zusätzlich ein Array `details`, Versandfehler geben `validation_errors` zurück. Tarifabhängige Funktionen geben `403` mit `"error": "plan_required"` zurück. Siehe [Fehler](/de/docs/api-reference/errors/).
- **Paginierung.** Listen-Endpunkte akzeptieren `page` und `limit` (1 bis 100) und geben `data`, `next_page_url` und `previous_page_url` zurück. Vorlagen und Automatisierungen verwenden `page` und `per_page`. Siehe [Paginierung](/de/docs/api-reference/pagination/).
- **Filtern und Sortieren.** Filtern Sie mit `field.condition=value`, kombinieren Sie Filter mit `match=all` oder `match=or` und sortieren Sie mit `order` und `direction`. Zum Beispiel `GET /v2/emails?status.exact=bounced&order=created_at&direction=desc`. Siehe [Filtern](/de/docs/api-reference/filtering/).
- **Idempotenz.** Senden Sie bei `POST /emails` und `POST /emails/:id/forward` einen Header `Idempotency-Key`, damit Wiederholungen sicher sind. Emailit liefert 24 Stunden lang die erste Antwort erneut aus. Siehe [Idempotenz](/de/docs/api-reference/idempotency/).
- **Rate Limits.** Der Versand ist pro Workspace begrenzt, standardmäßig auf 2 E-Mails pro Sekunde und 5.000 E-Mails pro Tag, gemeinsam für API und SMTP. Antworten enthalten `ratelimit-*`-Header, und eine Antwort mit `429` enthält `retry-after`. Siehe [Rate Limits](/de/docs/api-reference/rate-limits/) und [Limits](/de/docs/limits/).

## SDKs

Offizielle Bibliotheken kapseln die REST-API für Node.js, PHP, Laravel, Python, Ruby, Go, Java, .NET und Rust. Alle liegen auf [GitHub](https://github.com/emailit). Installationsbefehle finden Sie unter [SDKs und Bibliotheken](/de/docs/sdks/), vollständige Beispiele in den Framework-Anleitungen, beginnend mit [Node.js](/de/docs/frameworks/nodejs/).

## Webhooks

Webhooks senden Events an Ihren Endpunkt, sobald sie eintreten: Zustellungen, Bounces, Öffnungen, Klicks, eingehende E-Mails und Änderungen an Domains, Kontakten und anderen Ressourcen. Jede Anfrage enthält ein JSON-Array mit bis zu 100 Events und ist mit HMAC-SHA256 im Header `X-Emailit-Signature` signiert. Fehlgeschlagene Anfragen werden in bis zu 11 Versuchen wiederholt. Beginnen Sie mit [Webhook einrichten](/de/docs/webhooks/set-up/) und [Anfragesignatur](/de/docs/webhooks/request-signature/).

## MCP-Server und KI-Tools

Der gehostete [MCP-Server](/de/docs/mcp/) unter `https://api.emailit.com/mcp` stellt KI-Assistenten 109 Tools bereit, die die gesamte API v2 abdecken, vom E-Mail-Versand bis zu Kampagnen und Automatisierungen. Assistenten melden sich per OAuth oder mit einem API-Schlüssel an, und die [Emailit-Plugins](/de/docs/mcp/plugins-and-skills/) ergänzen Skills für ChatGPT, Codex, Claude Code, Cursor und Grok.

Die Doku wird auch für KI veröffentlicht: Jede Seite hat eine Markdown-Version, und [/docs/llms.txt](/de/docs/developers/llms-txt/) indexiert sie alle.

## Nächste Schritte

  - [API-Schlüssel erstellen](/de/docs/developers/api-keys/): Wählen Sie einen Scope, beschränken Sie den Schlüssel auf eine Domain und speichern Sie ihn sicher.
  - [Erste E-Mail senden](/de/docs/quickstart/api/): Führen Sie in wenigen Minuten Ihren ersten API-Aufruf aus.
  - [SDKs und Bibliotheken](/de/docs/sdks/): Offizielle Bibliotheken für neun Sprachen und Frameworks.
  - [API-Referenz](/de/docs/api-reference/): Alle Endpunkte, Parameter und Antworten.

---
Quelle: https://emailit.com/de/docs/developers/