Anfrage-Logs

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.“

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
   401	Fehlender oder ungültiger API-Schlüssel. Unbekannte Schlüssel werden nicht erfasst.	Authentifizierung
   402	Nicht genug Credits für den Versand.	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
   409	Ein Duplikat oder eine Anfrage mit demselben Idempotency-Key, die noch verarbeitet wird.	Idempotenz
   413	Die Nachricht ist größer als 40 MB.	Anhänge
   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
   429	Versandlimit pro Sekunde oder pro Tag erreicht. Der Body enthält limit, current und retry_after.	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.

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.

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