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 wichtigFollowing paramater are mandatory to authentificate with YellowFox:

• 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.

• a hexkey to authentificate the company. Can be redefined by customer. This key must be send at every request. No response contains this key.
• vehicle, a hexkey to authentificate the vehicle. Can be redefined by customer. No response contains this key.

• group, a hexkey authentificate a group.  Can be redefined by customer. No response contains this key.WIf you use a group key, please check that every car in this group also have a rti key!

Execute as 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 If "ERROR:Text" enthält is returned. "Text" die Fehlerbeschreibung. Mögliche Fehler:

Abarbeitungsfehler

Mögliche Fehlercodes werden unter Fehlerwerte beschriebencontains the error description. Possible error codes ca you find here.