GET HwStructure/getAllPersonWithCurrentAccess?HwStructNodePath={HwStructNodePath}&PageNumber={PageNumber}&PageSize={PageSize}&Token={Token}
Retrieve list of Person with current access
Request Information
Authorization
- Authorization by token required
Availability
- Method can be used
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
HwStructNodePath |
Unique identification of the sensor in the system |
string |
Required |
PageNumber |
Optional parameter may be omitted. All records are displayed when is omitted otherwise specific page is displayed |
integer |
Matching regular expression pattern: ([0-9]+) |
PageSize |
Optional parameter may be omitted. Define number of records in the page. |
integer |
Matching regular expression pattern: ([0-9]+) |
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 | 1221 | Show hw structure privilege violated |
404 required resource does not exist on the server | 1220 | Hw structure unit 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
HwStructureGetAllPersonWithCurrentAccessRespName | Description | Type | Additional information |
---|---|---|---|
PersonsWithCurrentAccess | Collection of PersonWithCurrentAccess |
None. |
|
Paging | PagingResp |
None. |
Response Formats
application/json
Sample:
{"PersonsWithCurrentAccess":[{"PersonId":"100200300","FullName":"Doo John"},{"PersonId":"100200301","FullName":"Smith James"},{"PersonId":"100200302","FullName":"Parish Ian"}],"Paging":{"CurrentPage":5,"PageSize":25,"TotalCount":128,"TotalPages":5}}
application/xml
Sample:
<Response> <PersonsWithCurrentAccess> <PersonWithCurrentAccess> <PersonId>100200300</PersonId> <FullName>Doo John</FullName> </PersonWithCurrentAccess> <PersonWithCurrentAccess> <PersonId>100200301</PersonId> <FullName>Smith James</FullName> </PersonWithCurrentAccess> <PersonWithCurrentAccess> <PersonId>100200302</PersonId> <FullName>Parish Ian</FullName> </PersonWithCurrentAccess> </PersonsWithCurrentAccess> <Paging> <CurrentPage>5</CurrentPage> <PageSize>25</PageSize> <TotalCount>128</TotalCount> <TotalPages>5</TotalPages> </Paging> </Response>
text/json
Sample:
{ "PersonsWithCurrentAccess": [ { "PersonId": "sample string 1", "FullName": "sample string 2" }, { "PersonId": "sample string 1", "FullName": "sample string 2" } ], "Paging": { "CurrentPage": 1, "PageSize": 2, "TotalCount": 3, "TotalPages": 4 } }
text/xml
Sample:
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <PersonsWithCurrentAccess> <PersonWithCurrentAccess> <PersonId>sample string 1</PersonId> <FullName>sample string 2</FullName> </PersonWithCurrentAccess> <PersonWithCurrentAccess> <PersonId>sample string 1</PersonId> <FullName>sample string 2</FullName> </PersonWithCurrentAccess> </PersonsWithCurrentAccess> <Paging> <CurrentPage>1</CurrentPage> <PageSize>2</PageSize> <TotalCount>3</TotalCount> <TotalPages>4</TotalPages> </Paging> </Response>