GET identifier/setHolderDefault?InternalNrLong={InternalNrLong}&Token={Token}
Set HolderDefault for specified identifier in the system. Application privilege "Edit" for licensed agenda "Identifiers" required. It only makes sense for assigned personal cards (Type 0,1,2,4,6,7).
Request Information
Authorization
- Authorization by token required
Availability
- Method can be used
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| InternalNrLong |
Internal number of the identifier in hex format |
string |
Required Matching regular expression pattern: ([0-9a-fA-F]+) String length: inclusive between 0 and 20 |
| 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 |
| 202 Accepted for processing | 0 | Processed with results: Identifier [{0}] remains unchanged |
| 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 | 1142 | Privilege Edit of agenda Indentifiers violated for [{0}] |
| 403 server refuses fo fulfill the request | 1147 | Record permission Edit of agenda Identifiers violated for [{0}] |
| 403 server refuses fo fulfill the request | 0 | Processed with results: Identifier [{0}] remains unchanged |
| 403 server refuses fo fulfill the request | 1 | Db operation failed, agenda missing priviliges |
| 403 server refuses fo fulfill the request | 2 | Db operation failed, record missing priviliges |
| 403 server refuses fo fulfill the request | 4 | Db operation failed, already changed by another user |
| 403 server refuses fo fulfill the request | 5 | Db operation failed, already deleted by another user |
| 403 server refuses fo fulfill the request | 6 | Db operation failed, database data consistence violation |
| 403 server refuses fo fulfill the request | 7 | Db operation failed, operation can not be executed because another problems occured |
| 403 server refuses fo fulfill the request | 8 | Db operation failed, licence violation |
| 404 required resource does not exist on the server | 1140 | Identifier [{0}] 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
IdentifierGetResp| Name | Description | Type | Additional information |
|---|---|---|---|
| InternalNrLong |
Long internal number of the identifer in hexadecimal format |
string |
None. |
| RegistrationNr |
Registration number of the identifier |
string |
None. |
| Technology |
Used technology of the identifier. The meaning is : 0 UNIQUE (H4102); 1 High Security (HS); 2 MIFARE (MF); 3 ABA Track; 4 HID; 5 Desfire |
integer |
None. |
| Type |
Type of the idenfier. The meaning is: 0 - Card; 1 - Tag; 2 - Bracelet; 3 - Visiting card; 4 - Password; 5 - Article; 6 - Spare; 7 - eCard |
integer |
None. |
| Status |
Actual status of the identifier. The meaning is: 0 - free, not yet assigned; 1 - Already assigned; 2 - Lost; 4 - Configuration |
integer |
None. |
| Holder |
Person id or (License plate number if holder is a car) of the identifier holder |
string |
None. |
| Lock |
Lock flag of the identifier. The meaning is: 0 - open; 1 - locked |
integer |
None. |
| Security |
Security flag of the identifier; The meaning is: 0 - not secure identifier; 1 - secure identifier |
integer |
None. |
| ValidFrom |
The begin of the identifier validity in format "yyyy-mm-ddThh:mi:ss". The time is included |
string |
None. |
| ValidTo |
The end of the identifier validity in format "yyyy-mm-ddThh:mi:ss". The time is included |
string |
None. |
| TimeLastChange |
The last change time of the data record. Can be used to check manual modification of data record |
date |
None. |
| HolderDefault |
The identifier is default for its holder; The meaning is: 0 - is not default; 1 - is default |
integer |
None. |
| UdsCollection |
The collection of available user defined columns of the agenda in the system:
|
Collection of UdsOut |
None. |