Zum Hauptinhalt springen

API Reference

Die API Reference enthält die verfügbaren Endpunkte, Parameter und Antwortbeispiele für die VPC-Systeme. Die produktive VPC API v2 ist unter https://api.ucp.li/v2 erreichbar und benötigt einen API-Key. Die Pfade in den Tabellen werden direkt an diese Basis-URL angehängt. Verwende kein zusätzliches /api.

Verfügbare APIs

VPC API v2 Kurzüberblick

Die interaktive VPC API v2 Reference enthält die vollständigen Details, Response-Beispiele und Schemas.

Fahrzeuge

MethodePfadBeschreibung
GET/vehiclesFahrzeuge des API-Key-Netzwerks paginiert listen
POST/vehiclesFahrzeug im API-Key-Netzwerk erstellen
GET/vehicles/{vehicle}Einzelnes Fahrzeug anzeigen
PUT/vehicles/{vehicle}Fahrzeugdaten aktualisieren
PATCH/vehicles/{vehicle}Einzelne Fahrzeugfelder aktualisieren
DELETE/vehicles/{vehicle}Fahrzeug löschen

Stempeluhr

MethodePfadBeschreibung
POST/dutytime/{identifier}/toggleStempeluhr eines Officers starten oder offene Stempeluhr-Einträge stoppen
POST/dutytime/{identifier}/stopOffene Stempeluhr-Einträge eines Officers stoppen; mehrfaches Aufrufen bleibt erfolgreich

Für die Stempeluhr gilt:

  • Es ist keine Body-Payload erforderlich. Optional kann ein leerer JSON-Body ({}) gesendet werden.
  • identifier ist der beim Officer hinterlegte FiveM-Identifier inklusive Prefix, z. B. license:0000000000000000000000000000000000000000.
  • Der Typ muss zur Connector-Konfiguration passen. Weitere Details findest du unter Identifier verstehen.
  • Nutze /dutytime/{identifier}/stop für gezieltes Beenden oder Retry-Logik.
  • /dutytime/{identifier}/toggle ist für Clients gedacht, die bewusst zwischen Start und Stop wechseln.

Beispiel:

curl -X POST \
"https://api.ucp.li/v2/dutytime/license:0000000000000000000000000000000000000000/stop" \
-H "X-API-Key: test-api-key" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{}'

Die internen /fivem-Routen sind absichtlich nicht in der API-Referenz dokumentiert.

Nutzung

Auf jeder API-Seite kannst du:

  • Endpunkte über die linke Navigation auswählen.
  • HTTP-Methoden, Pfade und Parameter prüfen.
  • Response-Beispiele und Schema-Informationen einsehen.
  • Zwischen den Produkt-APIs über die Tabs oberhalb der Referenz wechseln.

Hinweise

Die API-Spezifikationen dienen als Referenz für Integrationen. Für produktive Zugangsdaten, Umgebungen oder Freischaltungen nutze die vereinbarten Support- und Onboarding-Kanäle. Wie du einen API-Key erstellst, steht unter API-Key erstellen.