Eine Nachricht an ein einzelnes Fahrzeug, eine Gruppe oder alle (import) senden. Beschreibungdo_message.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=NachrichtMessage&language=deugbr&responsetype=2&format=xml&freeresponses=a%3A2%3A%7Bi%3A0%3Bs%3A6%3A%22Montag%22%3Bi%3A1%3Bs%3A8%3A%22Dienstag%22%3B%7D Parameter| Parameter | BeschreibungDescription | TypType | HinweisNote | PflichtMandatory |
|---|
| company | RTI Firmenschlüsselcompany key | string | | jayes | | vehicle | RTI Fahrzeugschlüsselvehicle key | string | entweder either vehicle oder , group oder or import werden erwartetparameter | (jayes) | | group | RTI Gruppenschlüsselgroup key | string | entweder either vehicle oder , group oder or import werden erwartetparameter | (jayes) | | import | RTI Importschlüssel | string | entweder either vehicle oder , group oder or import werden erwartetparameter | (jayes) | | messagetext | | string | Maximale Nachrichtenlängemaximal text length: - CE-Displays displays + Android Fleetandroid fleet: 500 Zeichensigns
- all other displaysAlle anderen Displays: 200 Zeichensigns
| jayes | | responsetypeTyp der Antwortmöglichkeit | type of the response | integer | 1 = keine vorgegebene Antwort (Standardno answer given (standard) 2 = Bestätigung erwartetconfirmation expected 3 = Jayes-/Neinno-Antwort erwartetanswer expected 4 = vorgegebene Antworten ( für Fleet-Displays ab Version reply template ( only for fleet-displays version higher 3.0)
| neinno | | freeresponses | vorgegebene Antwortmöglichkeiten | serialisiertes Array | serialized array | necessary for notwendig für responsetype = 4 | neinno | | language | Sprache | string | only for responsetypes 2 and 3 necessary supported params nur für Responsetype 2 und 3 unterstützte Parameter: deu (Standardstandard), gbr, ndl, fra, ita | neinno | | format | Rückgabeformat | string | format of the result from the interface supported formats Format der zurückgelieferten Antwort der Schnittstelle unterstüzte Formate: csv (Standardstandard), xml, json | neinno |
RückgabewerteEs wird standardmäßig ein CSV-String zurückgegeben, welcher zu jedem Fahrzeug die Auswertung und bei erfolgreichen Versenden auch den SESSIONKEY enthält. Bei fehlenden Pflichtparametern wird ein "ERROR:Beschreibung" zurückgegeben ReturnBy default, a CSV string is returned which contains the evaluation for each vehicle and the SESSIONKEY for successful dispatch. If the mandatory parameters are missing, an "ERROR: Description" is returned. Return exampleBeispielrückgabe: | Code Block |
|---|
| language | php |
|---|
| title | Rückgabe als Return as XML |
|---|
| <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE yf_domessage SYSTEM "http://map.yellowfox.de/rti/dtd/yf_domessage.dtd">
<yf_domessage>
<message>
<car>Car 1</car>
<result>OK</result>
<sessionkey>8a810da98bc0583af5959af0e8dde59g</sessionkey>
</message>
</yf_domessage>
|
| Code Block |
|---|
| title | Rückgabe als Return as JSON |
|---|
| [{"car":"Car 1","result":"ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED"},{"car":"Car 2","result":"OK","sessionkey":"8a810da98bc0583af5959af0e8dde59g"},{"car":"Car 3","result":"ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3"}] |
| Code Block |
|---|
| title | Rückgabe als Return as CSV |
|---|
| "CAR";"RESULT";"SESSIONKEY"
"Car 1";"ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED";""
"Car 2";"OK";"8a810da98bc0583af5959af0e8dde59g"
"Car 3";"ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3";""
|
BeispieleExamples | Code Block |
|---|
| title | normale Nachricht an einzelnes Fahrzeugsimple message to the vehicle |
|---|
| http://map.yellowfox.de/rti/do_message.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=RTI%20do_message%20test |
| Code Block |
|---|
| title | Bestätigungsnachricht an Gruppe mit englischer Bestätigung und gewünschten Rückgabeformat als Confirmation message to a group with english confirmation and desired return format as CSV |
|---|
| http://map.yellowfox.de/rti/do_message.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=2&language=gbr&format=csv |
| Code Block |
|---|
| title | Ja-Nein-Nachricht an alle mit englischer Bestätigung und gewünschten Rückgabeformat als Yes-No message to all with english confirmation and desired return format as XML |
|---|
| http://map.yellowfox.de/rti/do_message.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=3&language=gbr&format=xml |
| Code Block |
|---|
| title | Nachricht mit Antwortvorlage an alle, mit gewünschten Rückgabeformat als xml und der Antwortvorlage als serialisiertem ArrayMessage with reply template to all, with desired return format as xml and the response template as a serialized array |
|---|
| http://map.yellowfox.de/rti/do_message.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&messagetext=RTI%20do_message%20test&responsetype=4&format=xml&freeresponses=a%3A2%3A%7Bi%3A0%3Bs%3A6%3A%22Montag%22%3Bi%3A1%3Bs%3A8%3A%22Dienstag%22%3B%7D
|
yes |