...
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group oder import werden erwaret | ja |
| group | RTI Gruppenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | alle Fahrzeuge die zur Firma gehören | ja |
| messagetext | Maximale Nachrichtenlänge:
| ja | ||
| responsetype | Typ der Antwortmöglichkeit | integer | 1 = Standard (keine vorgegebene Antwort) 2 = Bestätigung erwartet 3 = Ja-/Nein-Antwort erwartet 4 = vorgegebene Antworten ( für Fleet-Displays ab Verion 3.0) Standard: 1 | nein |
| freeresponses | vorgegebene Antwortmöglichkeiten | serialisiertes Array | notwendig für responsetype = 4 | nein |
| language | Sprache | string | nur für Responsetype 2 und 3 unterstützte Parameter: deu, gbr, ndl, fra, ita Standard: deu | nein |
| format | Format | string | Format der zurückgelieferten Antwort der Schnittstelle unterstüzte Formate: csv, xml, json Standard: json | nein |
Rückgabewerte
Es wird standardmäßig ein string zurückgegeben. Bei Erfolg wird als Antwort "SESSKEY:SESSIONKEY" zurückgegeben. Ansonsten JSON-String zurückgegeben, welcher die zu jedem Fahrzeug die Auswertung und bei Erfolg auch den SESSIONKEY enthält. Bei fehlenden Pflichparametern wird ein "ERROR:Beschreibung" zurückgegeben
...
| Code Block | ||
|---|---|---|
| ||
//normale Nachricht an einzelnes Fahrzeug http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=RTI%20do_message%20test // Bestätigungsnachricht an Gruppe mit englischer Bestätigung und gewünschten Rückgabeformat als CSV http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=2&language=gbr&format=csv // Ja-Nein-Nachricht an alle mit englischer Bestätigung und gewünschten Rückgabeformat als xml http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=3&language=gbr&format=xml // Nachricht mit Antwortvorlage an alle mit gewünschten Rückgabeformat als xml und der Antwortvorlage als serialisiertes Array http://map.yellowfox.de/rti/do_message.asp?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=4&format=xml&freeresponses=a%3A3%3A%7Bi%3A0%3Bs%3A15%3A%22Verz%F6gerung+2h%21%22%3Bi%3A1%3Bs%3A22%3A%22Habe+Kunden+informiert%22%3Bi%3A2%3Bs%3A18%3A%22Ladung+vollst%E4ndig%22%3B%7D |
Beispielrückgabe