Logy požadavků

Email API›Logs zaznamenává provoz API a SMTP, který dorazí do Emailitu s vašimi API klíči. Když odeslání selže dřív, než vůbec vznikne e-mail, například kvůli chybě validace nebo limitu rychlosti, v logu požadavků uvidíte, co váš kód odeslal a co přesně Emailit odpověděl.

Co se zaznamenává

Záhlaví stránky to shrnuje: „Successful and failed API v2 and SMTP requests authenticated with an API key.“

Nezaznamenává se:

• Požadavky s chybějícím nebo neznámým API klíčem, protože je nelze přiřadit k workspace. Pokud dostáváte 401 Invalid API key a tady nic nevidíte, zkontrolujte, který klíč váš kód používá.
• Činnost ve webovém rozhraní a úspěšné příkazy SMTP AUTH.

Citlivé hodnoty se před uložením skryjí. Pole s názvy jako password, secret, token, authorization nebo api_key a hodnoty, které vypadají jako API klíče (secret_…) nebo tokeny, se nahradí za [redacted]. Dlouhé řetězce se zkracují na 16 384 znaků a pole na 50 položek, takže velké přílohy se nezobrazí celé.

Najděte požadavek

• Časové období: zvolte Last 1 hour, Last 6 hours, Last 24 hours (výchozí), Last 72 hours, Last 7 days nebo Last 30 days, nebo vyberte vlastní rozsah dat. Období můžete také přiblížit tažením přes graf.
• Graf: úspěšné a neúspěšné požadavky v čase, abyste poznali, kdy chyby začaly.
• Vyhledávání: hledá v cestě, zprávě, metodě a stavu.
• Filtry: Source (API, nebo SMTP), Outcome (Success, nebo Error), Method, Path, Message, Status code, Duration, Created a API key.

Tabulka zobrazuje Timestamp, Level (Success pro stavové kódy pod 400, jinak Error), Source, Method, Message (například POST /v2/emails → 422), Status a Duration.

Přečtěte si požadavek

Výběrem řádku požadavek otevřete. Stránka zobrazuje:

• Created, Level, Source a Status.
• Request body: JSON, který váš kód odeslal, u SMTP příkaz, obálku a souhrn zprávy.
• Response body: co Emailit vrátil, včetně podrobností o chybě.
• Details: ID logu, cestu, dobu trvání, ID API klíče (credential_id), IP adresu, user agent a ID požadavku.

Laďte chyby 4xx

1. Vyfiltrujte chyby. Nastavte Outcome na Error, nebo Status code na kód, který jste dostali, a zvolte období, které selhání pokrývá.

2. Otevřete požadavek a přečtěte si tělo odpovědi. Chybová těla Emailitu říkají, co se pokazilo. Chyby validace vypisují jednotlivé problémy v validation_errors nebo details.

3. Porovnejte je s tělem požadavku. Zkontrolujte pole, která Emailit dostal. Typická překvapení jsou chybějící doména v from, to odeslané jako objekt nebo scheduled_at v nečekaném formátu.

4. Zvolte řešení podle stavového kódu.

   Stav	Častá příčina	Kde se dozvíte víc
   400	Chybně formátovaný JSON nebo chyba validace.	Chyby
   401	Chybějící nebo neplatný API klíč. Neznámé klíče se nezaznamenávají.	Autentizace
   402	Nedostatek kreditů na odeslání.	Kredity
   403	Workspace není ověřený a některý příjemce není člen (unverified_workspace_recipient), klíč je omezený na jinou doménu, funkce vyžaduje vyšší tarif (plan_required), nebo je workspace zablokovaný.	Produkční přístup
   409	Duplicita, nebo ještě probíhající požadavek se stejným Idempotency-Key.	Idempotence
   413	Zpráva je větší než 40 MB.	Přílohy
   422	Požadavek je platný, ale nelze ho provést, například opakované odeslání e-mailu, který znovu odeslat nelze.	Chyby
   429	Dosažen limit odesílání za sekundu nebo denní limit. Tělo obsahuje limit, current a retry_after.	Limity rychlosti

   U SMTP se stejné problémy projeví jako kódy odpovědi SMTP, například 530, když doména odesílatele není ověřená, nebo 452 u limitů rychlosti. Viz Řešení problémů se SMTP.

5. Opravte a odešlete znovu. Požadavek, který selhal s 4xx, nevytvořil e-mail, takže ho po opravě můžete bezpečně odeslat znovu.

Pokud tu požadavek uspěl, ale e-mail nedorazil, problém nastal později. Najděte e-mail v Email API›Emails a přečtěte si jeho pokusy o doručení.

Uchovávání

Logy požadavků se řídí dobou uchovávání Logy:

	Pay as you go	Pro	Business	Custom
Uchovávání logů požadavků	7 dní	30 dní	30 dní	Flexibilní

Logy požadavků jsou dostupné jen ve webovém rozhraní; API endpoint pro ně neexistuje.

Související