...
get_messages.php?company=RTI_COMPANYKEY&vehicle=RTI_VEHICLEKEY&language=deu&datefrom=YYYYMMDD&dateto=YYYYMMDD&timefrom=HHMMSS&timeto=HHMMSS&filter=1,2,3&sessionkey=ABABABABABABABABABABABABABABAB&format=xml
Parameter
...
| Parameter | Beschreibung | Typ | Hinweis | Pflicht | |||||
|---|---|---|---|---|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | ||||||
| vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja) | |||||
| group | RTI Gruppenschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja) | |||||
| import | RTI Importschlüssel | string | entweder vehicle oder group oder import werden erwartet | (ja) | |||||
| datefrom | Datum ab dem alle Aufträge zurückgegeben werden | string | Format: YYYYMMDD oder DD.MM.YYYY | ja | |||||
| datefrom | Datum bis zu dem alle Aufträge zurückgegeben werden | string | Format: YYYYMMDD oder DD.MM.YYYY Die maximale Zeitspanne beträgt 7 Tage. | ja | |||||
| timefrom | Präzisierung des Anfangsdatums mit der Zeit | string | Format: HHMMSS | nein | |||||
| timeto | Präzisierung des Enddatums mit der Zei | string | Format: HHMMSS | nein | |||||
| filterTyp der Antwortmöglichkeit | Filtermöglichkeit nach Nachrichtentyp | integer | 1 = keine vorgegebene Antwort (Standard)erhalten 4 = vorgegebene Antworten ( für Fleet-Displays ab Version 3.0) | nein | freeresponses | vorgegebene Antwortmöglichkeiten | serialisiertes Array | Nachricht gesendet
| nein |
| language | Bestimmt die Ausgabesprache | string |
| nein | |||||
| format | Rückgabeformat | string | Format der zurückgelieferten Antwort der Schnittstelle unterstüzte Formate: csv (Standard), xml, json | nein
| Parameter | Beschreibung | Typ | Hinweis | Pflicht|
| sessionkey | enthaelt den Sessionkey aus "do_message.aspphp" | string | Entweder dieses Feld ist gesetzt, oder DATEFROM und DATETO | ja | |||||
| datefrom | Datum ab dem alle Aufträge zurückgegeben werden | string | Format: YYYYMMDD oder DD.MM.YYYY | ja | |||||
| dateto | Datum bis zu dem alle Aufträge zurückgegeben werden | string | Format: YYYYMMDD oder DD.MM.YYYYDie maximale Zeitspanne beträgt 7 Tage. | jatimefrom | Präzisierung des Anfangsdatums mit der Zeit | string | Format: HHMMSS | nein | |
| timeto | Präzisierung des Enddatums mit der Zeit | string | Format: HHMMSS | nein | |||||
| datetype | "insertdate" gibt alle Einträge zurück welche im abgefragten Zeitraum im Rechenzentrum verarbeitet worden sind | string | nein
|
Mögliche Nachrichtenstatus
| Status | Erläuterung |
|---|---|
| Zustellungsversuch | Die Nachricht hat das YellowFox Rechenzentrum verlassen |
| Zugestellt | Die Nachricht ist auf dem Display erfolgreich angekommen |
| Display ausgeschaltet | Das Display kann die Nachricht nicht empfangen, da es ausgeschaltet ist |
| Nachricht bereits vorhanden | Die Nachricht kann nicht erneut zugestellt werden, da diese bereits vorhanden ist |
| Nachricht erhalten | Es ist eine Nachricht im Portal angekommen, welche auf einem Display erstellt wurde |
| Nachricht gelesen | Nachricht wurde auf dem Display gelesen |
| Nachricht gelöscht | Nachricht wurde auf dem Display gelöscht |
| Nachricht konnte nicht zugestellt werden | Die Nachricht hat das Display nicht erreicht, weitere Zustellungsversuche werden nicht durchgeführt |
| Nachricht mit Antwortvorlagen gesendet | Die Nachricht wurde mit Antwortvorlagen versendet |
| Ja/Nein Nachricht gesendet | Die Nachricht wurde mit einer Ja-Nein-Option als Antwort versendet |
| Bestätigungsnachricht gesendet | Die Nachricht wurde mit einer Bestätigungsoption versendet |
| Antwort erhalten | Eine Antwort des Displays ist eingegangen |
Rückgabe
Es wird eine string CSV-Stringzurück gegeben. Ansonsten wird bei einem Fehler ein "ERROR:Beschreibung" zurückgegeben
Abfrage über Sessionkey
Metainformationen
...
Spalten
Spalte | Beschreibung | |
|---|---|---|
| DATE | Datum der ausgeführten Aktion | Format: DD.MM.YYYY HH:MM:SS |
| STATE | Beschreibung der Aktion | |
| SOURCE | Auslöser der Aktion | Person/Fahrzeugkennzeichen |
...
Rückgabe über Zeitraumabfrage
Metainformationen
| Trennzeichen | Komma ( , ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
...