# Anfrage-Logs

> Prüfen Sie jede Anfrage an die API v2 und jede SMTP-Transaktion mit Ihren API-Schlüsseln, einschließlich Anfrage- und Antwort-Body, um 4xx-Fehler zu debuggen.

**Email API → Logs** erfasst den API- und SMTP-Verkehr, der Emailit mit Ihren API-Schlüsseln erreicht. Wenn ein Versand fehlschlägt, bevor überhaupt eine E-Mail erstellt wird, zum Beispiel wegen eines Validierungsfehlers oder eines Rate Limits, sehen Sie im Anfrage-Log, was Ihr Code gesendet und was Emailit genau geantwortet hat.

## Was erfasst wird

Der Seitenkopf fasst es zusammen: „Successful and failed API v2 and SMTP requests authenticated with an API key.“

| Quelle | Was erfasst wird |
| --- | --- |
| **API** | Jede Anfrage an `https://api.emailit.com/v2/…`, die Emailit Ihrem Workspace zuordnen kann: Methode, Pfad, Statuscode, Dauer, API-Schlüssel, IP-Adresse, User-Agent sowie Anfrage- und Antwort-Body. |
| **SMTP** | Jeder Befehl `DATA` mit dem Ergebnis (`250 2.0.0 OK: queued as em_…` oder dem Fehler), dem Envelope-Absender, den Empfängern, Headern und der Nachrichtengröße. Außerdem Ablehnungen bei `MAIL FROM` wegen Rate Limits (`452`) und fehlgeschlagene `AUTH`-Versuche mit einem widerrufenen API-Schlüssel (`535`). |

Nicht erfasst werden:

- Anfragen mit fehlendem oder unbekanntem API-Schlüssel, weil sie keinem Workspace zugeordnet werden können. Erhalten Sie `401 Invalid API key` und sehen hier nichts, prüfen Sie, welchen Schlüssel Ihr Code verwendet.
- Aktivitäten in der Weboberfläche und erfolgreiche SMTP-Befehle `AUTH`.

Sensible Werte werden vor dem Speichern geschwärzt. Felder mit Namen wie `password`, `secret`, `token`, `authorization` oder `api_key` sowie Werte, die wie API-Schlüssel (`secret_…`) oder Tokens aussehen, werden durch `[redacted]` ersetzt. Lange Strings werden bei 16.384 Zeichen abgeschnitten und Arrays bei 50 Elementen, sodass große Anhänge nicht vollständig erscheinen.

## Anfrage finden

- **Zeitraum:** Wählen Sie **Last 1 hour**, **Last 6 hours**, **Last 24 hours** (Standard), **Last 72 hours**, **Last 7 days** oder **Last 30 days** oder einen eigenen Datumsbereich. Sie können auch über das Diagramm ziehen, um in einen Zeitraum hineinzuzoomen.
- **Diagramm:** erfolgreiche und fehlgeschlagene Anfragen im Zeitverlauf, damit Sie erkennen, wann Fehler begonnen haben.
- **Suche:** durchsucht Pfad, Meldung, Methode und Status.
- **Filter:** **Source** (API oder SMTP), **Outcome** (Success oder Error), **Method**, **Path**, **Message**, **Status code**, **Duration**, **Created** und **API key**.

Die Tabelle zeigt **Timestamp**, **Level** (Success bei Statuscodes unter 400, sonst Error), **Source**, **Method**, **Message** (zum Beispiel `POST /v2/emails → 422`), **Status** und **Duration**.

## Anfrage lesen

Wählen Sie eine Zeile aus, um sie zu öffnen. Die Seite zeigt:

- **Created**, **Level**, **Source** und **Status**.
- **Request body:** das JSON, das Ihr Code gesendet hat, oder bei SMTP den Befehl, den Envelope und eine Zusammenfassung der Nachricht.
- **Response body:** was Emailit zurückgegeben hat, einschließlich Fehlerdetails.
- **Details:** Log-ID, Pfad, Dauer, ID des API-Schlüssels (`credential_id`), IP-Adresse, User-Agent und Anfrage-ID.

## 4xx-Fehler debuggen

1. **Auf Fehler filtern.** Setzen Sie **Outcome** auf Error oder **Status code** auf den erhaltenen Code und wählen Sie einen Zeitraum, der den Fehlschlag abdeckt.

2. **Anfrage öffnen und Antwort-Body lesen.** Die Fehler-Bodys von Emailit sagen, was schiefgelaufen ist. Validierungsfehler listen jedes Problem in `validation_errors` oder `details` auf.

3. **Mit dem Anfrage-Body vergleichen.** Prüfen Sie die Felder, die Emailit erhalten hat. Typische Überraschungen sind eine fehlende Domain in `from`, `to` als Objekt gesendet oder ein `scheduled_at` in einem unerwarteten Format.

4. **Lösung passend zum Statuscode wählen.**

   | Status | Häufige Ursache | Mehr dazu |
   | --- | --- | --- |
   | `400` | Fehlerhaftes JSON oder ein Validierungsfehler. | [Fehler](/de/docs/api-reference/errors/) |
   | `401` | Fehlender oder ungültiger API-Schlüssel. Unbekannte Schlüssel werden nicht erfasst. | [Authentifizierung](/de/docs/api-reference/authentication/) |
   | `402` | Nicht genug Credits für den Versand. | [Credits](/de/docs/billing/credits/) |
   | `403` | Der Workspace ist nicht verifiziert und ein Empfänger ist kein Mitglied (`unverified_workspace_recipient`), der Schlüssel ist auf eine andere Domain beschränkt, die Funktion erfordert einen höheren Tarif (`plan_required`) oder der Workspace ist gesperrt. | [Produktionszugang](/de/docs/workspaces/production-access/) |
   | `409` | Ein Duplikat oder eine Anfrage mit demselben `Idempotency-Key`, die noch verarbeitet wird. | [Idempotenz](/de/docs/api-reference/idempotency/) |
   | `413` | Die Nachricht ist größer als 40 MB. | [Anhänge](/de/docs/email-api/attachments/) |
   | `422` | Die Anfrage ist gültig, lässt sich aber nicht ausführen, zum Beispiel das erneute Senden einer E-Mail, die dafür nicht in Frage kommt. | [Fehler](/de/docs/api-reference/errors/) |
   | `429` | Versandlimit pro Sekunde oder pro Tag erreicht. Der Body enthält `limit`, `current` und `retry_after`. | [Rate Limits](/de/docs/api-reference/rate-limits/) |

   Bei SMTP zeigen sich dieselben Probleme als SMTP-Antwortcodes, zum Beispiel `530`, wenn die From-Domain nicht verifiziert ist, oder `452` bei Rate Limits. Siehe [SMTP-Fehlerbehebung](/de/docs/smtp/troubleshooting/).

5. **Beheben und erneut senden.** Eine Anfrage, die mit `4xx` fehlgeschlagen ist, hat keine E-Mail erstellt. Sie können sie nach der Korrektur also gefahrlos erneut senden.

War die Anfrage hier erfolgreich, aber die E-Mail ist nicht angekommen, ist das Problem später aufgetreten. Suchen Sie die E-Mail unter **Email API → Emails** und lesen Sie ihre [Zustellversuche](/de/docs/logs/email-details/#deliveries-loads-and-clicks).

## Aufbewahrung

Anfrage-Logs folgen dem Aufbewahrungszeitraum für **Logs**:

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Aufbewahrung der Anfrage-Logs | 7 Tage | 30 Tage | 30 Tage | Flexibel |

Anfrage-Logs sind nur in der Weboberfläche verfügbar; es gibt keinen API-Endpunkt dafür.

## Siehe auch

  - [API-Fehler](/de/docs/api-reference/errors/)
  - [SMTP-Fehlerbehebung](/de/docs/smtp/troubleshooting/)

---
Quelle: https://emailit.com/de/docs/logs/request-logs/
