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
| Methode | Pfad | Beschreibung |
|---|---|---|
GET | /vehicles | Fahrzeuge des API-Key-Netzwerks paginiert listen |
POST | /vehicles | Fahrzeug 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
| Methode | Pfad | Beschreibung |
|---|---|---|
POST | /dutytime/{identifier}/toggle | Stempeluhr eines Officers starten oder offene Stempeluhr-Einträge stoppen |
POST | /dutytime/{identifier}/stop | Offene 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. identifierist 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}/stopfür gezieltes Beenden oder Retry-Logik. /dutytime/{identifier}/toggleist 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.