La pagina Utilizzo degli endpoint API ti offre una vista completa di come stanno performando le tue integrazioni API. Puoi monitorare lo stato di salute di ogni endpoint, tracciare l’avanzamento dell’implementazione e approfondire i log delle singole chiamate API per indagare eventuali errori.
Cosa ti serve:
Accesso a Vehicle Management.
La tab API Endpoints.
🧭 Come accedere
Vai su Vehicle Management e seleziona la tab API Endpoints dalla navigazione in alto.
📋 Elenco degli endpoint
La pagina mostra tutti gli endpoint API attivi, ordinati alfabeticamente. Ogni card endpoint mostra:
Endpoint name — il nome dell’endpoint API.
API Health status — un indicatore a colori delle prestazioni correnti:
🟢 Healthy (verde) — l’endpoint funziona normalmente.
🟡 Concerning (giallo) — sono stati rilevati errori; da monitorare.
🔴 High error rate (rosso) — una quota significativa di chiamate recenti fallisce.
⛔ All calls failed (rosso) — tutte le chiamate recenti hanno restituito un errore.
Implementation status — a che punto è l’endpoint nel ciclo di rollout:
✅ Implemented (verde) — l’endpoint è completamente live.
🛠️ Under implementation (giallo) — l’endpoint è ancora in fase di configurazione.
💤 Inactive > 30 days (grigio) — nessuna chiamata registrata da oltre 30 giorni.
🔎 Dettagli dell’endpoint
Clicca su una card endpoint per espanderla. La vista espansa include:
Source — l’identificatore dell’integrazione che effettua le chiamate.
First Call — la data della primissima chiamata registrata.
Last Call — la data della chiamata più recente.
Implemented At — la data in cui l’endpoint è stato marcato come implementato (se applicabile).
Webhook Status — lo stato corrente della subscription webhook associata (se applicabile).
Tabella Recent Activity — dettaglio giorno per giorno con data, numero di chiamate e codice HTTP per ciascuna voce. I codici sono colorati: verde per successi (2xx) e rosso per errori (4xx/5xx).
🧾 Visualizzare i dettagli delle chiamate API
Dalla tabella Recent Activity, clicca "View details" su una riga (oppure clicca direttamente la riga) per aprire il modal API Call History. Il modal mostra:
Un header riassuntivo con nome endpoint, source, data e conteggio totale delle chiamate.
Un log scorrevole delle singole chiamate API con:
numero di riga
codice di stato HTTP (colorato)
URL della request
timestamp (in UTC)
Per risposte di errore (4xx/5xx), clicca expand per vedere il messaggio di errore e il payload della request, utile per il debugging.
Il log carica i risultati in pagine da 50 e recupera automaticamente altri risultati mentre scorri.
💡Nota: c’è un ritardo nella sincronizzazione dei log dettagliati. I log recenti di oggi potrebbero non essere ancora visibili. I payload delle request vengono registrati solo per risposte di errore (4xx/5xx).
Serve aiuto?
Ask our AI Assistant: per una guida in tempo reale, usa l’AI Assistant disponibile direttamente nella UI della piattaforma Visibility.
Send Feedback: il tuo feedback è importante. Clicca sull’icona "?" in basso a sinistra e seleziona "Send feedback."
Support Portal: per problemi tecnici che richiedono assistenza umana, visita il nostro Support Portal.