get_messagestate.asp

Last modified by YellowFox_RD on 2024/12/19 10:11

Table of Contents

Description
Parameter
Return
- Query by Sessionkey
- Return via time range
  - Metainformations
  - Columns
Example Calls

DEPRECATED

Return message states

Description

get_messagestate.asp?company=RTI_COMPANYKEY&vehicle=RTI_VEHICLEKEY&language=deu&DATEFROM=YYYYMMDD&DATETO=YYYYMMDD&timefrom=HHMMSS&timeto=HHMMSS&datetype=insertdate

Parameter

Parameter	Description	Type	Note	Mandatory
company	RTI company key	string		yes
vehicle	RTI vehicle key	string	only used for secondary authentification	yes
language	define output language	string	kein Wert oder "deu" = Deutsch "gbr" = englisch "fra" = französisch "ita" = italienisch	no
sessionkey	SeesionKey from "do_message.asp	string	this field or DATEFROM and DATETO are mandatory	yes
DATEFROM	begin of requested timerange	string	Format: YYYYMMDD	yes
DATETO	end of requested timerange	string	Format: YYYYMMDD Maximum time range is 7 days	yes
timefrom	more precise of DATEFROM	string	Format: HHMMSS	no
timeto	more precise if DATETO	string	Format: HHMMSS	no
datetype	"insertdate" returns all states which are processed/inserted at data center in the requested timerange	string		no

Return

A string will be returned. In case of error "ERROR:Description" is given.

Query by Sessionkey

Metainformations

Delimiter	Comma ( , )
Text Delimiter	not available
Line End	0x0D 0x0A (CarriageReturn LineFeed)
Header	Line 1

Columns

Column	Description
DATE	Date of state action	Format: DD.MM.YYYY HH:MM:SS
STATE	Description of state action
SOURCE	source of state action	Person/Vehcile

Example

DATE,STATE,SOURCE
04.08.2010 09:48:41,Nachricht gelöscht,PND / Fahrzeugname
04.08.2010 09:43:24,Nachricht gelesen,PND / Fahrzeugname
04.08.2010 09:42:24,Zugestellt,PND / Fahrzeugname
04.08.2010 09:41:54,Zustellungsversuch,PORTAL / RTI

Return via time range

Metainformations

Delimiter	Comma ( , )
Text Delimiter	Double Quote ( " )
Line End	0x0D 0x0A (CarriageReturn LineFeed)
Header	Line 1

Columns

Spalte	Beschreibung
DATE	Date of state action	Format: DD.MM.YYYY HH:MM:SS
STATE	Description of state action
SOURCE	source of state action (Person)
SRCNAME	source of state action (System)
KEY	Sessionkey of message
REQUESTDATE	Systemtime of request	Format: DD.MM.YYYY HH:MM:SS
INSERTDATE	Systemtime of insert	Format: DD.MM.YYYY HH:MM:SS

Example

"DATE","STATE","SOURCE","SRCNAME","KEY","REQUESTDATE","INSERTDATE"
"04.08.2010 09:48:41","Nachricht gelöscht","PND","Fahrzeugname","ABABABABABABABABABABABABABABABAB","04.08.2010 09:50:00","04.08.2010 09:49:23"
"04.08.2010 09:43:24","Nachricht gelesen",PND","Fahrzeugname","ABABABABABABABABABABABABABABABAB","04.08.2010 09:50:00","04.08.2010 09:44:10"
"04.08.2010 09:42:24","Zugestellt",PND,"Fahrzeugname","ABABABABABABABABABABABABABABABAB","04.08.2010 09:50:00","04.08.2010 09:43:11"
"04.08.2010 09:41:54","Zustellungsversuch","PORTAL","RTI","ABABABABABABABABABABABABABABABAB","04.08.2010 09:50:00","04.08.2010 09:42:11"

Example Calls

Query by SessionKey
https://map.yellowfox.de/rti/get_messagestate.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&language=deu&sessionkey=SESSION_KEY

Query by time range based on insert date
https://map.yellowfox.de/rti/get_messagestate.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&language=deu&DATEFROM=TT.MM.JJJJ&DATETO=TT.MM.JJJJ&timefrom=HHMMSS&timeto=HHMMSS&datetype=insertdate