vehicle_groups/manage_assignments.php

Version 1.1 von YellowFox_RD am 2024/12/19 10:11

Inhaltsverzeichnis

Verwaltung der Fahrzeuggruppen-Zuweisungen.
Hier können einzelne Fahrzeuge einer Gruppe hinzugefügt oder von einer Gruppe entfernt werden.

Beschreibung

GET vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&group=GROUP_RTIKEY&task=assign

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstringja
vehicleRTI Fahrzeugschlüsselstringja
groupRTI Gruppenschlüsselstringja
taskAufgabestringKann folgende Werte annehmen:
  • assign (hinzufügen)
  • remove (entfernen)
ja

Rückgabe

Es wird ein string zurückgegeben.  Bei Erfolg wird als Antwort "OK" zurückgegeben. Ansonsten wird ein "ERROR:Beschreibung" zurückgegeben.

Mögliche Fehlerwerte

FehlerBeschreibung
MISSING_COMPANYFirmenschlüssel fehlt
INVALID_COMPANYFirma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen.
ERROR_MAINTENANCEIhre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich.
MISSING_GROUPGruppenschlüssel fehlt
INVALID_GROUP_KEYGruppenschlüssel passt zu keiner Gruppe
MISSING_TASKEs wurde kein Task angebeben.
MISSING_VEHICLEFahrzeugschlüssel fehlt
INVALID_KEY(VEHICLE|GROUP|IMPORT)Fahrzeugschlüssel entspricht nicht dem Format eines RTI Schlüssels
INVALID_VEHICLE_KEYFahrzeugschlüssel passt zu keinem Fahrzeug
CAR_ALREADY_IN_GROUPFahrzeug ist bereits in der angegebenen Gruppe
CAR_IS_NOT_IN_GROUPFahrzeug ist derzeit nicht in der angegebenen Gruppe
UNKNOWN_TASK([TASK])Task hat einen unzulässigen Wert
ERROR_WHILE_[TASK]Fehler beim Speichern der neuen Zuweisung

Beispielaufruf

Hinzufügen eines Fahrzeugs zu einer Gruppe
https://map.yellowfox.de/rti/vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&group=GROUP_RTIKEY&task=assign

https:
//map.yellowfox.de/rti/vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&group=GROUP_RTIKEY&task=assign