Erste Schritte
API-Referenz
Vollständige Referenz für alle Emailit API v2-Endpunkte, Anfrage-Formate und Response-Schemas.
Basis-URL
Alle API-Anfragen sollten an die folgende Basis-URL gerichtet werden. Wir unterstützen ausschließlich sichere HTTPS-Anfragen.
Unsere aktuelle API-Version ist v2 mit folgender Basis-URL:
Authentifizierung
Die Emailit API v2 verwendet API-Schlüssel zur Authentifizierung von Anfragen. Sie können Ihre API-Schlüssel im Emailit Dashboard einsehen und verwalten.
Ihre API-Schlüssel gewähren weitreichende Berechtigungen – bewahren Sie sie daher sicher auf! Teilen Sie Ihre geheimen API-Schlüssel niemals in öffentlich zugänglichen Bereichen wie GitHub, clientseitigem Code oder ähnlichem.
Rate Limits
Unsere API v2 und SMTP haben ein anfängliches Rate Limit von 2 Nachrichten pro Sekunde für neue Workspaces. Sie können jederzeit ein höheres Rate Limit im Emailit Dashboard beantragen.
Jeder Workspace hat außerdem ein anfängliches Rate Limit von 5000 Nachrichten pro Tag.
Response-Codes
Die API verwendet standardmäßige HTTP-Response-Codes, um Erfolg oder Fehler anzuzeigen.
| Status-Code | Beschreibung |
|---|---|
| 200 | OK - Die Anfrage war erfolgreich |
| 400 | Bad Request - Ungültige Anfrage-Parameter |
| 401 | Unauthorized - Ungültiger oder fehlender API-Schlüssel |
| 403 | Forbidden - Zugriff auf die angeforderte Ressource verweigert |
| 404 | Not Found - Angeforderte Ressource existiert nicht |
| 429 | Too Many Requests - Rate Limit überschritten |
| 500 | Internal Server Error - Auf unserer Seite ist ein Fehler aufgetreten |