# Log delle richieste > Analizza ogni richiesta all’API v2 e transazione SMTP fatta con le tue chiavi API, compresi i corpi della richiesta e della risposta, per risolvere gli errori 4xx. **Email API → Logs** registra il traffico API e SMTP che raggiunge Emailit con le tue chiavi API. Quando un invio non riesce prima ancora che venga creata un’email, ad esempio per un errore di convalida o un limite di frequenza, il log delle richieste è il posto dove vedi cosa ha inviato il tuo codice e cosa ha risposto esattamente Emailit. ## Cosa viene registrato L’intestazione della pagina lo riassume: «Successful and failed API v2 and SMTP requests authenticated with an API key.» | Origine | Cosa viene registrato | | --- | --- | | **API** | Ogni richiesta a `https://api.emailit.com/v2/…` che Emailit può associare al tuo workspace: metodo, percorso, codice di stato, durata, chiave API, indirizzo IP, user agent e i corpi della richiesta e della risposta. | | **SMTP** | Ogni comando `DATA`, con il risultato (`250 2.0.0 OK: queued as em_…` o l’errore), il mittente della busta, i destinatari, gli header e la dimensione del messaggio. Anche i rifiuti di `MAIL FROM` dovuti ai limiti di frequenza (`452`) e i tentativi di `AUTH` non riusciti con una chiave API revocata (`535`). | Non vengono registrati: - Le richieste con una chiave API mancante o sconosciuta, perché non si possono collegare a un workspace. Se ricevi `401 Invalid API key` e qui non vedi nulla, controlla quale chiave usa il tuo codice. - L’attività nel pannello e i comandi SMTP `AUTH` riusciti. I valori sensibili vengono oscurati prima del salvataggio. I campi con nomi come `password`, `secret`, `token`, `authorization` o `api_key`, e i valori che sembrano chiavi API (`secret_…`) o token, vengono sostituiti con `[redacted]`. Le stringhe lunghe vengono troncate a 16.384 caratteri e gli array a 50 elementi, quindi gli allegati grandi non compaiono per intero. ## Trova una richiesta - **Intervallo di tempo:** scegli **Last 1 hour**, **Last 6 hours**, **Last 24 hours** (predefinito), **Last 72 hours**, **Last 7 days** o **Last 30 days**, oppure scegli un intervallo di date personalizzato. Puoi anche trascinare sul grafico per ingrandire un periodo. - **Grafico:** le richieste riuscite e non riuscite nel tempo, così puoi individuare quando sono iniziati gli errori. - **Ricerca:** trova corrispondenze nel percorso, nel messaggio, nel metodo o nello stato. - **Filtri:** **Source** (API o SMTP), **Outcome** (Success o Error), **Method**, **Path**, **Message**, **Status code**, **Duration**, **Created** e **API key**. La tabella mostra **Timestamp**, **Level** (Success per i codici di stato inferiori a 400, Error altrimenti), **Source**, **Method**, **Message** (ad esempio `POST /v2/emails → 422`), **Status** e **Duration**. ## Leggi una richiesta Seleziona una riga per aprirla. La pagina mostra: - **Created**, **Level**, **Source** e **Status**. - **Request body:** il JSON inviato dal tuo codice, oppure per SMTP il comando, la busta e il riepilogo del messaggio. - **Response body:** cosa ha restituito Emailit, compresi i dettagli dell’errore. - **Details:** l’ID del log, il percorso, la durata, l’ID della chiave API (`credential_id`), l’indirizzo IP, lo user agent e l’ID della richiesta. ## Risolvi gli errori 4xx 1. **Filtra gli errori.** Imposta **Outcome** su Error, o **Status code** sul codice che hai ricevuto, e scegli un intervallo che copra l’errore. 2. **Apri la richiesta e leggi il corpo della risposta.** I corpi di errore di Emailit spiegano cosa è andato storto. Gli errori di convalida elencano ogni problema in `validation_errors` o `details`. 3. **Confrontalo con il corpo della richiesta.** Controlla i campi che Emailit ha ricevuto. Le sorprese tipiche sono un dominio `from` mancante, `to` inviato come oggetto o uno `scheduled_at` in un formato inatteso. 4. **Scegli la soluzione in base al codice di stato.** | Stato | Causa comune | Dove saperne di più | | --- | --- | --- | | `400` | JSON non valido o errore di convalida. | [Errori](/it/docs/api-reference/errors/) | | `401` | Chiave API mancante o non valida. Le chiavi sconosciute non vengono registrate. | [Autenticazione](/it/docs/api-reference/authentication/) | | `402` | Crediti insufficienti per l’invio. | [Crediti](/it/docs/billing/credits/) | | `403` | Il workspace non è verificato e un destinatario non è un membro (`unverified_workspace_recipient`), la chiave è limitata a un altro dominio, la funzione richiede un piano superiore (`plan_required`) o il workspace è sospeso. | [Accesso alla produzione](/it/docs/workspaces/production-access/) | | `409` | Un duplicato, oppure una richiesta con lo stesso `Idempotency-Key` ancora in corso. | [Idempotenza](/it/docs/api-reference/idempotency/) | | `413` | Il messaggio supera i 40 MB. | [Allegati](/it/docs/email-api/attachments/) | | `422` | La richiesta è valida ma non si può eseguire, ad esempio ritentare un’email che non lo consente. | [Errori](/it/docs/api-reference/errors/) | | `429` | Raggiunto il limite di invio al secondo o giornaliero. Il corpo include `limit`, `current` e `retry_after`. | [Limiti di frequenza](/it/docs/api-reference/rate-limits/) | Per SMTP, gli stessi problemi compaiono come codici di risposta SMTP, ad esempio `530` quando il dominio From non è verificato o `452` per i limiti di frequenza. Vedi [Risoluzione dei problemi SMTP](/it/docs/smtp/troubleshooting/). 5. **Correggi e reinvia.** Una richiesta non riuscita con un `4xx` non ha creato un’email, quindi puoi inviarla di nuovo in sicurezza dopo averla corretta. Se qui la richiesta risulta riuscita ma l’email non è arrivata, il problema si è verificato dopo. Trova l’email in **Email API → Emails** e leggi i suoi [tentativi di consegna](/it/docs/logs/email-details/#deliveries-loads-and-clicks). ## Conservazione I log delle richieste seguono il periodo di conservazione **Logs**: | | Pay as you go | Pro | Business | Custom | | --- | --- | --- | --- | --- | | Log delle richieste conservati | 7 giorni | 30 giorni | 30 giorni | Flessibile | I log delle richieste sono disponibili solo nel pannello; non esiste un endpoint API per consultarli. ## Vedi anche - [Errori dell’API](/it/docs/api-reference/errors/) - [Risoluzione dei problemi SMTP](/it/docs/smtp/troubleshooting/) --- Fonte: https://emailit.com/it/docs/logs/request-logs/