Zum Hauptinhalt springen

API-Endpunkt-Nutzung

A
Verfasst von Arek
Heute aktualisiert

Auf der Seite API-Endpunkt-Nutzung erhältst du einen vollständigen Überblick darüber, wie deine API-Integrationen performen. Du kannst den Zustand (Health) jedes Endpunkts überwachen, den Implementierungsfortschritt verfolgen und in einzelne API-Call-Logs eintauchen, um Fehler zu untersuchen.

Was du brauchst:

  • Zugriff auf Vehicle Management.

  • Den Tab API Endpoints.


🧭 Zugriff

Navigiere zu Vehicle Management und wähle in der oberen Navigation den Tab API Endpoints.


📋 Endpunktliste

Die Seite zeigt alle aktiven API-Endpunkte, alphabetisch sortiert. Jede Endpunkt-Karte enthält:

  • Endpoint name — der Name des API-Endpunkts.

  • API Health status — ein farbcodierter Indikator, wie der Endpunkt aktuell performt:

    • 🟢 Healthy (grün) — der Endpunkt funktioniert normal.

    • 🟡 Concerning (gelb) — es wurden Fehler erkannt; sollte beobachtet werden.

    • 🔴 High error rate (rot) — ein signifikanter Anteil der letzten Calls schlägt fehl.

    • All calls failed (rot) — alle letzten Calls an diesen Endpunkt haben einen Fehler zurückgegeben.

  • Implementation status — wo sich der Endpunkt im Rollout-Lebenszyklus befindet:

    • Implemented (grün) — der Endpunkt ist vollständig live.

    • 🛠️ Under implementation (gelb) — der Endpunkt wird noch eingerichtet.

    • 💤 Inactive > 30 days (grau) — seit über 30 Tagen wurden keine Calls aufgezeichnet.


🔎 Endpunktdetails

Klicke auf eine Endpunkt-Karte, um sie zu erweitern. In der erweiterten Ansicht siehst du:

  • Source — die Integrations-ID, die die Calls ausführt.

  • First Call — das Datum, an dem der allererste API-Call aufgezeichnet wurde.

  • Last Call — das Datum des zuletzt aufgezeichneten API-Calls.

  • Implemented At — das Datum, an dem der Endpunkt als implementiert markiert wurde (falls zutreffend).

  • Webhook Status — der aktuelle Status des zugehörigen Webhook-Abonnements (falls zutreffend).

  • Recent Activity-Tabelle — eine tägliche Aufschlüsselung mit Datum, Anzahl der Calls und HTTP-Statuscode pro Eintrag. Statuscodes sind farbcodiert: grün für Erfolg (2xx) und rot für Fehler (4xx/5xx).


🧾 API-Call-Details ansehen

Klicke in der Recent Activity-Tabelle bei einer Zeile auf "View details" (oder klicke die Zeile direkt), um das Modal API Call History zu öffnen. Dort siehst du:

  • Einen Header mit Endpunktname, Source, Datum und Gesamtanzahl der Calls.

  • Ein scrollbares Log einzelner API-Calls mit:

    • Zeilennummer

    • HTTP-Statuscode (farbcodiert)

    • Request-URL

    • Zeitstempel (in UTC)

  • Bei Fehlerantworten (4xx/5xx) kannst du über den Expand-Button die Fehlermeldung und den Request-Payload einblenden, was beim Debugging hilft.

Das Log lädt Ergebnisse in Seiten zu je 50 Einträgen und lädt automatisch nach, während du scrollst.

💡Hinweis: Es gibt eine Verzögerung beim Synchronisieren detaillierter Logs. Sehr aktuelle Logs von heute sind möglicherweise noch nicht sichtbar. Request-Payloads werden nur für Fehlerantworten (4xx/5xx) protokolliert.

Hilfe benötigt?

  • Frag unseren AI Assistant: Für Unterstützung in Echtzeit nutze den AI Assistant direkt in der Visibility-Plattform.

  • Feedback senden: Wir freuen uns über dein Feedback. Klicke auf das "?"-Symbol unten links und wähle "Send feedback."

  • Support Portal: Für technische Themen, die menschliche Unterstützung erfordern, besuche unser Support Portal.

Hat dies deine Frage beantwortet?