When subscribing for a '.state.mode4' parameter of a SatService ACU-ODM, the front end receives a message which indicates 'a new tracking history for this antenna is available' instead of sending the bulky tracking history itself over the websocket connection.
After the front end received this message, it can use the /api/v1/trackmem API call to retrieve the full tracking history as a TrackingHistory data object.
Supported HTTP methods: GET, HEAD, OPTIONS
GET /api/v1/trackmem/{odmName}
Parameters:
| Parameter | Description |
|---|---|
| odmName | The device name of the ODM for which the tracking history shall be read. This must be a fully qualified name including name of the M&C where the ODM is managed. |
Expected Payload: none
Replied Payload: A TrackingHistory document containing the tracking history of the referenced antenna controller.
Return Codes:
| Code | Description |
|---|---|
| 200 | OK, the requested TrackingHistory document is returned. |
| 400 | Either the requested device does not exist or the device has not yet sent a tracking history. This may happen if the front end did no subscribe for the 'state.mode4' of the ODM before or if the ODM is not operational. In this case an ApiError document is returned, describing details of the error. |
| 401 | not logged in. In this case an ApiError document is returned, describing details of the error. |