Response Events
This section provides examples for Response Event types.
Current API
URI | Method | Description |
---|---|---|
|
GET | This API retrieves the most recent response events of the specified device. It provides option to filter the data for specific responseType. |
Method: GET
URI:
http://<<IDShostname>>/ids-data-api/v1/response-events/current/352253064335021?param=/device/0/battery&responseType=read
Response: 200 OK:
[
{
"groupName": "tempco",
"deviceId": "352253064335021",
"serverTime": "2017-01-25T10:23:33.341+0000",
"param": "/device/0/battery",
"value": "0",
"requestId": "968703ad-971a-476f-9f28-5db797c1c17c",
"resultCode": "0",
"resultSubCode": "null",
"resultReason": "SUCCESS",
"responseType": "read"
}
]
Historical API
URI | Method | Description |
---|---|---|
|
GET |
This API retrieves all the response event values of specified devices' parameters and event type in the specified time range. If specific parameters are specified in " + "as part of the request params then only those specific parameters will be retrieved. |
Method: GET
http://<<IDShostname>>/ids-data-api/v1/response-events/history?fromTime=2017-01-25T00:00:00&toTime=2020-06-16T23:00:00&deviceId=352253064335021, 352753095787619¶m=/device/0/battery&pageSize=3&responseType=read
Response: 200 OK:
[
{
"groupName": "tempco",
"deviceId": "352253064335021",
"serverTime": "2017-01-25T10:23:33.341+0000",
"param": "/device/0/battery",
"value": "0",
"requestId": "968703ad-971a-476f-9f28-5db797c1c17c",
"resultCode": "0",
"resultSubCode": "null",
"resultReason": "SUCCESS",
"responseType": "read"
},
{
"groupName": "tempco",
"deviceId": "352753095787619",
"serverTime": "2017-01-25T10:23:33.341+0000",
"param": "/device/0/battery",
"value": "0",
"requestId": "968703ad-971a-476f-9f28-5db797c1c17d",
"resultCode": "0",
"resultSubCode": "null",
"resultReason": "SUCCESS",
"responseType": "read"
}
]
Bulk APIs
URI | Method | Description |
---|---|---|
|
GET |
This API retrieves all the response events of all the devices in the specified time range for all the response event type. The response consists of a list of JSON formatted data, separated by newlines. |
Method: GET
http://<<IDShostname>>/ids-data-api/v1/response-events/bulk?fromTime=2017-01-25T00:00:00&toTime=2020-06-18T23:00:00
Response: 200 OK:
{"groupName":"tempco","deviceId":"352753095787619", "serverTime":"2017-01-25T10:23:33.341+0000", "param":"/device/0/battery","value":"0", "requestId":"968703ad-971a-476f-9f28-5db797c1c17c", "resultCode":"0","resultSubCode":"null", "resultReason":"SUCCESS","responseType": "read"}
{"groupName":"tempco","deviceId":"352253064335021", "serverTime":"2017-01-25T10:23:33.341+0000", "param":"/device/0/pressure","value":"0", "requestId":"968703ad-971a-476f-9f28-5db797c1c17d", "resultCode":"0","resultSubCode":"null", "resultReason":"SUCCESS","responseType": "read"}