GET HwStructure/getC4HwEvents?C4Identification={C4Identification}&LastSync={LastSync}&Token={Token}
Retrieve all events assigned to C4 system connection. Application privilege "View" for licensed agenda "Data" required.
Request Information
Authorization
- Authorization by token required
Availability
- Method can be used
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| C4Identification |
C4 identification. It is used to identify the C4 system in the system Aktion. |
string |
Required |
| LastSync |
C4 last datetime synchronization |
date |
Required |
| Token |
The action is authorized by this token. Token should generated by calling action "POST login". Expiration time of each token is 20 seconds |
globally unique identifier |
Required |
Body Parameters
None.
Response Information
Response Codes
| Http Code | Error Number | Description |
|---|---|---|
| 200 request succesfully done | 0 | Successfully done |
| 400 bad request | 1002 | Entry parameter missing or parameter bindigs failed |
| 401 unauthorized | 1000 | Token {0} not found |
| 401 unauthorized | 1001 | Token {0} already expired |
| 401 unauthorized | 1006 | Ip filter violated for ip client address [{0}] |
| 401 unauthorized | 1007 | Ip filter [{0}] parsing failed |
| 401 unauthorized | 1008 | Request rate policy violated for [{0}] |
| 403 server refuses fo fulfill the request | 1227 | Show hw structure physical privilege violated |
| 404 required resource does not exist on the server | 1228 | Hw structure physical not found |
| 415 unsupported Media Type | The request entity has a media type which the server or resource does not support. Only application/json and application/xml are supported | |
| 500 internal error | Server exception description |
Resource Description
HwStructGetC4HwEventsResp| Name | Description | Type | Additional information |
|---|---|---|---|
| C4HwEvents | Collection of C4HwEvents |
None. |
Response Formats
application/json, text/json
Sample:
{
"C4HwEvents": [
{
"ID": "a713136a-8671-4a17-aed3-eaf3ed1e74c3",
"HwStructureId": "d3ded1c1-3a9a-4426-b6f2-f8ddcabff9da",
"DateCreated": "2026-10-06T01:23:12.2099097+02:00",
"Date": "2026-10-06T01:23:12.2099097+02:00",
"EventCode": 4,
"Direction": 1,
"OwnerId": "e6a2273a-0646-4bfb-b28f-acb1fc7abd2c",
"Identifier": "sample string 5",
"Zone": "sample string 6",
"Descriptions": "sample string 7"
},
{
"ID": "a713136a-8671-4a17-aed3-eaf3ed1e74c3",
"HwStructureId": "d3ded1c1-3a9a-4426-b6f2-f8ddcabff9da",
"DateCreated": "2026-10-06T01:23:12.2099097+02:00",
"Date": "2026-10-06T01:23:12.2099097+02:00",
"EventCode": 4,
"Direction": 1,
"OwnerId": "e6a2273a-0646-4bfb-b28f-acb1fc7abd2c",
"Identifier": "sample string 5",
"Zone": "sample string 6",
"Descriptions": "sample string 7"
}
]
}
application/xml, text/xml
Sample:
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<C4HwEvents>
<C4HwEvents>
<ID>a713136a-8671-4a17-aed3-eaf3ed1e74c3</ID>
<HwStructureId>d3ded1c1-3a9a-4426-b6f2-f8ddcabff9da</HwStructureId>
<DateCreated>2026-10-06T01:23:12.2099097+02:00</DateCreated>
<Date>2026-10-06T01:23:12.2099097+02:00</Date>
<EventCode>4</EventCode>
<Direction>1</Direction>
<OwnerId>e6a2273a-0646-4bfb-b28f-acb1fc7abd2c</OwnerId>
<Identifier>sample string 5</Identifier>
<Zone>sample string 6</Zone>
<Descriptions>sample string 7</Descriptions>
</C4HwEvents>
<C4HwEvents>
<ID>a713136a-8671-4a17-aed3-eaf3ed1e74c3</ID>
<HwStructureId>d3ded1c1-3a9a-4426-b6f2-f8ddcabff9da</HwStructureId>
<DateCreated>2026-10-06T01:23:12.2099097+02:00</DateCreated>
<Date>2026-10-06T01:23:12.2099097+02:00</Date>
<EventCode>4</EventCode>
<Direction>1</Direction>
<OwnerId>e6a2273a-0646-4bfb-b28f-acb1fc7abd2c</OwnerId>
<Identifier>sample string 5</Identifier>
<Zone>sample string 6</Zone>
<Descriptions>sample string 7</Descriptions>
</C4HwEvents>
</C4HwEvents>
</Response>