add_driver_license_check.php

Zuletzt geändert von YellowFox_RD am 2025/01/23 10:17

Inhaltsverzeichnis

Ermöglicht das importieren einer durchgeführten Führerscheinkontrolle

Beschreibung

POST   /personnel/add_driver_license_check.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&nfc_tag=NFC_TAG&date=20210324151000&terminal=optionales Terminal

POST   /personnel/add_driver_license_check.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&mode=csv_import&delimiter=COMMA&csv_structure[]={ "type" : "datetime", "pattern":"YmdHis"}&csv_structure[]={ "type" : "nfc_tag" }&headline=1

Parameter

Query-Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring ja
importRTI Importschlüsselstring ja
modeUnterscheidung der verschiedenen Aktionenstringzulässige Modi sind:
  • single_insert: einzelne Buchung (default)
  • csv_import: Import einer CSV Datei
nein
nfc_tagNFC Kennungstring ja, bei Modus single_insert
dateDatum in ME(S)ZstringFormat: YYYYMMDDHHMMSSja, bei Modus single_insert
terminalAn welchem Terminal wurde die Führerscheinkontrolle durchgeführtstring nein
delimiterWelches Trennzeichen wurde in der CSV verwendetstringCOMMA, SEMICOLON oder TABja, bei Modus csv_import
fileDateifile ja, bei Modus csv_import
csv_structure[]Pro Spalte ein Eintrag, was für ein Inhalt in der Spalte zu finden iststring[]
  • { "type" : "datetime", "pattern":"YmdHis"}
  • { "type" : "date", "pattern":"Ymd"}
  • { "type" : "time", "pattern":"His"}
  • { "type" : "terminal" }
  • { "type" : "nfc_tag" }
  • { "type" : "ignore" }
ja, bei Modus csv_import
headlineenthält die Datei eine Kopfzeileint0 = keine Kopfzeile (default), 1 = Kopfzeile vorhandennein

Body-Parameter

ParameterBeschreibungTypHinweisPflicht
fileDateifile ja, bei Modus csv_import

Rückgabe

Im Erfolgsfall wird "OK" zurückgegeben. bzw. beim CSV Import pro Zeile.
Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.

Beispiele

Single Import

https://map.yellowfox.de/rti/personnel/add_driver_license_check.php?company=COMPANY_KEY&import=IMPORTKEY&nfc_tag=abc123def&date=20210324151000&terminal=optionales Terminal

CSV Import

https://map.yellowfox.de/rti/personnel/add_driver_license_check.php?company=COMPANY_KEY&import=IMPORTKEY&&mode=csv_import&delimiter=COMMA&csv_structure[]={"type":"datetime","pattern":"YmdHis"}&csv_structure[]={"type":"nfc_tag"}&headline=1

Rückgabe CSV Import mit 3 Zeilen

{
   "1": "ERROR:NO DRIVER FOUND WITH NFC KEY: abc123def",
   "2": "OK",
   "3": "OK"
}