Entity Information
Data type: IncomingMessage, fields listURL: /api/messages/incoming
HTTP Method: POST
To send incoming message to the Trakopolis you need to pass following values:
- CreatedOn: Datetime of message creation. UTC only
- Message: Message text
- Status: Information about your current position. Status.Latitude and Status.Longitude are recommended to be filled with valid coordinates. Status.MessageCode field should be equal to "Text Message"
- Terminal: Information about terminal. Either Terminal.Id or Terminal.SerialNumber should be filled.
There is a delay before message becomes available on the Trakopolis website and API server. The Trakopolis API server returns ApiStatusResult response if message is added successfully (Error code = NoError) or custom error code if an error has ocurred. Some errors may cause 4xx Http status code result. Please refer to the "Error Handling" section
Json-based request example:
{ "Message": "API client test message for terminal ID=123456789", "CreatedOn": "2013-01-01T00:00:00.0000000Z", "Terminal": { "Id": 123456789 }, "Status": { "Latitude": 51.04917, "Longitude": -114.06083, "MessageCode": "Text Message" } }