Log delle richieste

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

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
   401	Chiave API mancante o non valida. Le chiavi sconosciute non vengono registrate.	Autenticazione
   402	Crediti insufficienti per l’invio.	Crediti
   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
   409	Un duplicato, oppure una richiesta con lo stesso Idempotency-Key ancora in corso.	Idempotenza
   413	Il messaggio supera i 40 MB.	Allegati
   422	La richiesta è valida ma non si può eseguire, ad esempio ritentare un’email che non lo consente.	Errori
   429	Raggiunto il limite di invio al secondo o giornaliero. Il corpo include limit, current e retry_after.	Limiti di frequenza

   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.

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.

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