Panoramica

La pagina Log API ti mostra cosa sta succedendo con le tue attività API in tempo reale, in tutto il tuo account. È stata creata per offrirti tranquillità, permettendoti di vedere rapidamente cosa funziona, individuare tempestivamente i problemi e capire come comunicano i tuoi sistemi.

I log vengono conservati per 7 giorni e includono:

Richieste andate a buon fine
Richieste non riuscite
Log dettagliati per ogni richiesta
Payload completi di richiesta e risposta

Puoi usare questa pagina per verificare se le richieste sono state consegnate con successo, esaminare eventuali errori e tenere traccia delle attività nei tuoi servizi connessi, tutto da un'unica semplice vista.

Accesso alla pagina dei Log API

Dal menu di sinistra, cerca Sviluppatore.
Clicca su Strumenti Sviluppatore > Log API

Componenti

1. Riepilogo: 'La tua attività recente'

Queste metriche ti offrono visibilità istantanea sul tuo utilizzo delle API.
Mostra i numeri complessivi per l'intervallo di date selezionato:

Richieste totali: Tutte le richieste API effettuate.
Andate a buon fine: Richieste che restituiscono gli stati 200 e 201
Non riuscite: Richieste che restituiscono gli stati 400, 401, 403, 404 e 50

2. Ricerca, Filtri & Applica

La funzione Ricerca e filtri ti aiuta a trovare rapidamente i log che stai cercando. Puoi cercare per parole chiave, filtrare per stato o restringere la ricerca per data per concentrarti sulle richieste più importanti.

Questa funzionalità si applica alle quattro pagine di log caricate inizialmente. Per cercare o filtrare tra più record, carica semplicemente pagine aggiuntive cliccando sulle pagine successive; la tua ricerca e i tuoi filtri verranno quindi applicati anche ai log appena caricati.

Cerca
Digita parole complete o parziali e la ricerca esaminerà tutti i seguenti campi per aiutarti a trovare rapidamente ciò di cui hai bisogno.
Ecco le possibili opzioni di ricerca:
- Endpoint API: Il percorso API specifico che viene richiamato.
- ID richiesta: Un identificatore univoco assegnato automaticamente a ogni richiesta API.
- Origine: Da dove è partita la richiesta (es., API, pannello di controllo, account secondario).
- Corpo: Il contenuto della richiesta, inclusi il testo del messaggio e i parametri.
- Paese: Il paese di destinazione del messaggio basato sul numero del destinatario.
- ID mittente: Il valore "da" utilizzato durante l'invio del messaggio (alfanumerico o numerico).
- Codice di risposta: Il codice numerico del sistema restituito dopo l'elaborazione della richiesta.
- Messaggio di risposta: Un breve messaggio che spiega il codice di risposta.
- Codice di errore: lo stato HTTP della chiamata
- Messaggio di errore: Una breve spiegazione di ciò che ha causato l'errore.
- ID messaggio: L'identificatore univoco per il singolo messaggio una volta in coda o inviato.
Filtri
- Stato: Filtra per completamento con successo, errori del client o errori del server.
- Endpoint: Filtra ad es. per /v3/sms/send, /v3/mms/send, /v3/sms/history, ecc.
- Account secondario: Per impostazione predefinita, sarà il tuo account secondario.
- Intervallo di date: Conserviamo i log solo per 7 giorni. Puoi selezionare tra queste opzioni:
  - Oggi
  - Ultime 12 ore
  - Ultime 24 ore
  - 2 giorni fa
  - 3 giorni fa
  - 4 giorni fa
  - 5 giorni fa
  - 6 giorni fa
“Nota: quando usi il filtro '2 giorni fa', mostrerà tutti i log degli ultimi due giorni, incluso oggi.
Pulsanti
- Cancella filtri: reimposta tutti i filtri, inclusa la ricerca.
- Applica: usalo per applicare i tuoi filtri attuali e la ricerca. Puoi cliccare su 'Applica' o semplicemente premere Invio per eseguire la ricerca.

3. Tabella dei log

Mostra tutte le richieste API in base ai tuoi filtri. Le colonne includono:

Usa questa tabella per scansionare rapidamente l'attività o identificare le chiamate non riuscite.

Ordinamento:

Puoi ordinare per qualsiasi colonna, ad esempio per Timestamp o Stato.
Cliccando sull'intestazione di una colonna alterna l'ordine crescente e decrescente.
Questo ti aiuta a raggruppare errori, attività recenti o endpoint specifici in modo più efficiente.

Interazioni:

Cliccando su una riga si aprono i dettagli completi della richiesta nel pannello di destra.
L'impaginazione ti permette di esplorare tutti i log e carica i dati successivi.
Aggiorna tabella ricarica i log più recenti.
Ordinamento sort

Pannelli dettagliati dei log (pannelli Metadati, Richiesta e Risposta)
Quando selezioni una riga, vengono visualizzati i dettagli completi.

Il pannello Metadati include:
- Metodo
- Stato
- Stato del messaggio (es. 200 Successo)
- ID richiesta
- Account secondario
- Timestamp
- Indirizzo IP del client
- User agent
Questa sezione aiuta a identificare la provenienza della richiesta (Postman, server, browser, ecc.).

Corpo della richiesta
Mostra l'esatto payload inviato. Utile per:
- Eseguire il debug di JSON malformato
- Verificare i parametri
- Controllare i metodi di autenticazione
Corpo della risposta
Mostra l'esatta risposta restituita. Include:
- Codici HTTP
- Messaggi di errore
- Codici di risposta interni
- Dati di consegna e prezzi (se applicabili)
Questo è il tuo strumento principale per la risoluzione di problemi come errori, messaggi di errore o payload errati.

Casi d'uso comuni

1. Eseguire il debug di chiamate API non riuscite

Apri il menu a tendina del filtro Stato
Clicca su una riga con 400 o 500.
Rivedi:
- Corpo della risposta (messaggio di errore)
- Corpo della richiesta (campi non corretti?)
- Endpoint utilizzato
- Account secondario che ha generato il trigger

2. Confermare che l'SMS/MMS è stato inviato correttamente

Filtra l'endpoint /v3/sms/send.
Controlla lo stato 200.
Ispeziona il corpo della risposta → Message queued for delivery.

3. Riprodurre o inoltrare i problemi

Copia i corpi della richiesta/risposta direttamente quando invii un rapporto sui problemi.

Suggerimenti

Usa la Ricerca per trovare rapidamente i log relativi a un numero di telefono o a una parola chiave specifici.
Per i problemi ricorrenti, confronta più log fianco a fianco.
I log si aggiornano automaticamente quando si clicca su Aggiorna tabella.
Usa il payload della risposta per comprendere i problemi di consegna o i prezzi.

DOMANDE FREQUENTI

Che cos'è la pagina dei log delle API?

La pagina dei log delle API consente agli sviluppatori di visualizzare e monitorare tutte le richieste API effettuate tramite il loro account. Aiuta a tracciare l'attività delle richieste, a identificare gli errori e a eseguire il debug delle integrazioni in tempo reale.

Quali informazioni posso vedere nei log delle API?

Ogni voce di log include dettagli chiave come:

Timestamp: quando è stata effettuata la richiesta
Endpoint: quale endpoint API è stato chiamato
Stato: se la richiesta è andata a buon fine o meno
Codice di risposta: codice di stato HTTP (es. 200, 400, 500)
ID richiesta: un identificatore univoco per ciascuna richiesta

Quali sono i contatori "Tutti", "Riusciti" e "Non riusciti"?

Questi contatori riepilogano l'attività delle tue richieste API:

Tutti: mostra il numero totale di chiamate API effettuate
Riusciti: mostra il conteggio delle richieste completate con successo
Non riusciti: mostra il conteggio delle richieste che hanno generato un errore

Come funziona l'impaginazione nella pagina dei log?

I log vengono visualizzati in pagine per rendere la navigazione più rapida e semplice.

Utilizza i controlli di impaginazione (ad es. Successivo, Precedente o le pagine numerate) per navigare nella cronologia dei tuoi log.

Cosa fa il pulsante "Aggiorna"?

Il pulsante Aggiorna ricarica la tabella dei log per mostrare l'attività API più recente senza ricaricare l'intero pannello di controllo.

Questo è utile quando si monitorano le richieste API in tempo reale.

Con quale frequenza vengono aggiornati i log?

I log vengono aggiornati quasi in tempo reale. Puoi cliccare manualmente su Aggiorna per ottenere istantaneamente i dati più recenti.

Fino a quando posso visualizzare i log delle API?

Puoi visualizzare i log degli ultimi 7 giorni.

I log più vecchi potrebbero essere archiviati o eliminati automaticamente.

Posso esportare i log delle mie API?

Attualmente, la funzionalità di esportazione potrebbe non essere disponibile direttamente sulla pagina.

Posso cercare o filtrare i miei log delle API?

Sì. Puoi filtrare i log per:

Stato (Riuscito, Non riuscito)
Intervallo di date
Endpoint
Ricerca - digita qualsiasi parola chiave

Cosa devo fare se una richiesta non è andata a buon fine?

Puoi:

Cliccare sulla voce del log non riuscita per visualizzare i dettagli e i messaggi di errore
Controllare il codice di risposta e il corpo dell'errore
Usare questi dati per risolvere i problemi della tua integrazione API

Chi può accedere alla pagina dei log delle API?

L'account e l'account secondario possono accedere e visualizzare i propri log delle API. In questa versione, è stato stabilito che gli account secondari possono visualizzare solo i propri.

Guida ai log delle API