Send a message to a single vehicle, a group or to all (import). Description do_message.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&messagetext=Message&language=gbr&responsetype=2&format=xml&freeresponses[]=Montag&freeresponses[]=Dienstag&dispatcher=Absender ParameterParameter | Description | Type | Note | Mandatory |
---|
company | RTI company key | string |
| yes | vehicle | RTI vehicle key | string | either vehicle, group or import parameter | (yes) | group | RTI group key | string | either vehicle, group or import parameter | (yes) | import | RTI import key | string | either vehicle, group or import parameter | (yes) | messagetext |
| string | maximal text length: - CE-displays + android fleet: 500 signs
- all other displays: 200 signs
| yes | responsetype | type of the response | integer | 1 = no answer given (standard) 2 = confirmation expected 3 = yes-/no-answer expected 4 = reply template (only for fleet-displays version higher 3.0)
| no | freeresponses | reply template | array | necessary for responsetype = 4 | no | language | language | string | only for responsetypes 2 and 3 necessary supported params: deu (standard), gbr, ndl, fra, ita | no | format | format of the result | string | format of the result from the interface supported formats: csv (standard), xml, json | no | dispatcher | Name of dispatcher | string | maximal text length: 100 signs only android fleet displays | no | attachments | file attachments | string | UUIDs of desired file attachments, comma-separated You get these UUIDs while uploading a file via file_storage/upload_file.php or you can access them via file_storage/get_overview.php | no |
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.
Separator | Semicolon ( ; ) |
---|
Delimiter | Double quote ( " ) |
---|
Line break | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Line 1 |
---|
Columns | |
---|
CAR | Vehicle-Name | RESULT | Result of the action | SESSIONKEY | Sessionkey of the message |
Example Code Block |
---|
title | Result format as CSV |
---|
| " | "CAR";"RESULT";"SESSIONKEY"
"Car 1";"ERROR_HARDWARE_COMBINATION_NOT_SUPPORTED";" | 8a810da98bc0583af5959af0e8dde59g"
"Car 3";"ERROR_HARDWARE_DONT_SHOW_RESPONSETYPE_3";""
|
Code Block |
---|
language | php |
---|
title | Result format as XML |
---|
| <?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
|