# Logy požadavků

> Prohlédněte si každý požadavek API v2 a každou SMTP transakci provedenou s vašimi API klíči včetně těl požadavků a odpovědí a odhalte příčinu chyb 4xx.

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

| Zdroj | Co se zaznamená |
| --- | --- |
| **API** | Každý požadavek na `https://api.emailit.com/v2/…`, který Emailit dokáže přiřadit k vašemu workspace: metoda, cesta, stavový kód, doba trvání, API klíč, IP adresa, user agent a těla požadavku a odpovědi. |
| **SMTP** | Každý příkaz `DATA` s výsledkem (`250 2.0.0 OK: queued as em_…` nebo chybou), odesílatelem v obálce, příjemci, hlavičkami a velikostí zprávy. Dále odmítnutí `MAIL FROM` kvůli limitům rychlosti (`452`) a neúspěšné pokusy o `AUTH` s odvolaným API klíčem (`535`). |

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](/cs/docs/api-reference/errors/) |
   | `401` | Chybějící nebo neplatný API klíč. Neznámé klíče se nezaznamenávají. | [Autentizace](/cs/docs/api-reference/authentication/) |
   | `402` | Nedostatek kreditů na odeslání. | [Kredity](/cs/docs/billing/credits/) |
   | `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](/cs/docs/workspaces/production-access/) |
   | `409` | Duplicita, nebo ještě probíhající požadavek se stejným `Idempotency-Key`. | [Idempotence](/cs/docs/api-reference/idempotency/) |
   | `413` | Zpráva je větší než 40 MB. | [Přílohy](/cs/docs/email-api/attachments/) |
   | `422` | Požadavek je platný, ale nelze ho provést, například opakované odeslání e-mailu, který znovu odeslat nelze. | [Chyby](/cs/docs/api-reference/errors/) |
   | `429` | Dosažen limit odesílání za sekundu nebo denní limit. Tělo obsahuje `limit`, `current` a `retry_after`. | [Limity rychlosti](/cs/docs/api-reference/rate-limits/) |

   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](/cs/docs/smtp/troubleshooting/).

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í](/cs/docs/logs/email-details/#deliveries-loads-and-clicks).

## 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í

  - [Chyby API](/cs/docs/api-reference/errors/)
  - [Řešení problémů se SMTP](/cs/docs/smtp/troubleshooting/)

---
Zdroj: https://emailit.com/cs/docs/logs/request-logs/