Goal of this application is to provide the basic tracking functionality of YellowFox to third party software. Easy use and strong security were scopes during development.

Common

Goal of this application is to provide the basic tracking functionality of YellowFox to third party software. Easy use and strong security were scopes during development. The user send commands via http to servers and receives the answers, positions, maps via the same way.

RTI can be used for example:

• Query of vehicle positions
• change of tracking settings
• configuration of displays
• send orders and messages
• receive order states

Activation

RTI must be activated from our support. Please feel free to contact them.

Base address

http://map.yellowfox.de/rti/ or https://map.yellowfox.de/rti/

Description of functioning

Folgende Parameter sind für die Anmeldung an YellowFox wichtig:

• company, als HEXadezimalKey auszuführen, kann vom Kunden selber neu generiert werden. Dieser Key wird in jeder Anfrage mitgesendet. Antworten enthalten diesen Key nicht. Der Key dient zur Authentifizierung. Dieser Key wird pro Kunde generiert und enthält unter anderem die Firmenid
• vehicle, als HEXadezimalKey auszuführen, kann vom Kunden selber neu generiert werden. Dieser Key wird bei Anfragen die Fahrzeuge betreffen mitgesendet. Antworten enthalten diesen Key nicht. Der Key dient als Fahrzeugkennung. Dieser Key wird pro Fahrzeug generiert.

• group, als HEXadezimalKey auszuführen, kann vom Kunden selber neu generiert werden. Dieser Key wird bei Anfragen die Fahrzeuggruppen betreffen mitgesendet. Antworten enthalten diesen Key nicht. Der Key dient als Fahrzeugkennung oder Gruppenkennung. Dieser Key wird pro Gruppe generiert. Wenn Sie einen Gruppenschlüssel verwenden, stellen Sie sicher, dass jedes Fahrzeug dieser Gruppe auch einen Fahrzeugschlüssel hat! 

• Datumsstempel, um Caching der Befehlsanfrage zu vermeiden.

Ausführung als ?company=HEXKEY&vehicle=HEXKEY2&ts=yyyymmddhhmmsszzzzzzzz

• yyyy = Jahr, vierstellig
• mm - Monat, zweistellig
• dd - Tag, zweistellig
• hh - Stunde, zweistellig
• mm - Minute, zweistellig
• ss - Sekunde, zweistellig
• zzzzzzzz - Zaehler für Anfrage, die Antwort enthält diesen Zaehler

Error codes

Bei der Rückgabe "ERROR:Text" enthält "Text" die Fehlerbeschreibung. Mögliche Fehler:

Abarbeitungsfehler

Mögliche Fehlercodes werden unter Error codes beschrieben.