Sv translation | ||||||
---|---|---|---|---|---|---|
| ||||||
Grundlegende Telematikfunktionen von YellowFox werden externen Programmen zugänglich gemacht.
AllgemeinDer Nutzer der Schnittstelle wird einen Befehl an den Webserver senden und erhält dabei eine Antwort zurück. Die Übertragung der Nutzdaten erfolgt über das Protokoll http bzw. https, so dass normalerweise keinerlei Anpassungen im IT-Equipment des Kunden notwendig sind. Das Remote Tracking Interface (RTI) erhält dabei eine speziell formatierte Anfrage und beantwortet diese mit dem Ergebnis des auf die Anfrage hin ausgeführten Befehls. Das RTI agiert dabei immer nur auf eine Anfrage. Es kann weder Daten von selber versenden noch ohne Zutun des Kunden von allein tätig werden. Das RTI lässt sich z.B. für folgende Dinge nutzen:
Die Funktionen des RTI können auf einfachste Weise mit Anwendungen wie Google Earth getestet werden. AktivierungDas RTI wird durch den Support bzw. Innendienst freigeschaltet. Kontaktieren Sie uns einfach an um dieses Modul für sich freizuschalten. Im Portal können Sie dann unter Extras -> RTI (Schnittstelle) RTI Schlüssel für Ihre Firma und den zugehörigen Fuhrpark erzeugen. Diese dienen dann als Authentifizierung. BasisadressierungBasisadresse für alle Abfragen ist http://map.yellowfox.de/rti/ bzw https://map.yellowfox.de/rti/ Beschreibung der FunktionsweiseDie Authentifizierung an der RTI Schnittstelle erfolgt über RTI Schlüssel. Diese finden Sie im Portal unter Extras → RTI Schnittstelle. Ihr Zugang besitzt zwei zentrale Schlüssel: den Firmenschlüssel und den Importschlüssel. Weiterhin können Sie für jedes Fahrzeug und jede Fahrzeuggruppe einen eigenen Schlüssel erzeugen. Je nach RTI Funktion benötigen Sie eine bestimmte Kombi an Schlüsseln. Informationen dazu finden Sie in der Beschreibung der jeweiligen Funktion. Die Schlüssel sind pro Firma eindeutig. Bei RTI Schlüsseln handelt es sich um einen Hexadezimal Schlüssel. Dieser wird zufällig generiert und kann beliebig oft neu erstellt werden. Für Fahrzeuge haben Sie optional auch die Möglichkeit eigene RTI Idents zu vergeben. Diese sind jedoch ausschließlich in einer 2-stufigen Authentifizierung nutzbar. RTI Schlüssel müssen bei jeder Anfrage mitgegeben werden, Sie sind jedoch nicht in der jeweiligen Antwort enthalten. Folgende Schlüssel sind für die Anmeldung an YellowFox wichtig:
Ausführung als ?company=HEXKEY&vehicle=HEXKEY2 FehlerwerteBei der Rückgabe "ERROR:Text" enthält "Text" die Fehlerbeschreibung. Mögliche Fehlercodes finden Sie hier. |
Sv translation | ||||||
---|---|---|---|---|---|---|
| ||||||
Goal of this application is to provide the basic tracking functionality of YellowFox to third party software.
CommonGoal 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 to:
ActivationRTI must be activated from our support. Please feel free to contact them. You can then access the rti interface settings via extras → rti interface. There you are able to generate the needed keys for authentication. Base addresshttp://map.yellowfox.de/rti/ or https://map.yellowfox.de/rti/ Description of functioningThe authentication at rti interface is realized by rti keys. You can find these in the user portal via extras → rti interface. Your access owns two central keys: the company key and the import key. Furthermore you are able to generate an own key for each vehicle and vehicle group. Depending on the rti function, you will need a specific combination of keys. You can find information about that in the documentation of the respective function. The keys are distinct per company. A rti key is a hexadecimal key. It will be generated at random and can be re-generated as often as you want. For vehicles you might also generate a custom rti ident, but these can only be used via 2-step authentication. Rti keys have to be send with each request. They are not included in the responses. Following keys are important to login via YellowFox:
Execute as ?company=HEXKEY&vehicle=HEXKEY2 Error codesIf "ERROR:Text" is returned. "Text" contains the error description. You can find possible error codes here. |