Entity Information (Request Data)
Data type: CheckOutData, fields listData is passed in request as XML or Json serialized data depending on response-type header value.
URL /api/LoneWorker/{assetId}/CheckOut
HTTP Method: POST
Description
Inserts "Check Out" message
assetId (mandatory): Asset identifier
Request data has 4 fields in CheckOutData structure posted as JSON or XML in request body:
- TerminalId - id of terminal to be updated. If terminalId is not specified it is detected automatically based on AssetId
- UtcDate - date/time in UTC timezone when "Check In" event occurred
- Latitude - the latitude of the location the event occurred on
- Longitude - the longitude of the location the event occurred on
If errors occured, the Trakopolis API server returns detailed error status with possible error codes:
- AssetMultipleTerminals - asset has multiple terminals and application should pass specific TerminalId to update value;
- AssetNotFound - requested asset is not found or can'be accessed by caller application;
- AssetNoTerminals - requested asset doesn't have any terminals;
- AssetTerminalNotFound - requested terminal is not found;
- TerminalNoLocationDateFound - failed to find existent status nearest to UtcDate. Probably terminal doesn't have any statuses yet.
- WrongDataFormat - Invalid input data format in VirtualOdometerData structure.