Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General request format:

POST http://IP-address:port/firserver/ReadPersons

Request parameters:

ParameterRequiredParameter description
server_idYes

ID of the Face Recognition Server in the Face - Intellect software package

idNo

Intellect user ID

If not specified, the response will return information about all users

pageNo

Number of results pages

If not specified, then page = 1

pageSize

No

Results per page

If not specified, then pageSize = 1, i.e. there will be 1 result on 1 page

Request example:

POST http://localhost127.0.0.1:10000/firserver/ReadPersons

...

Code Block
{
 "server_id": "1",
 "objectType": "PERSON",
 "id": [

 ],
 "page": 1,
 "pageSize": 2
}

Request headlines:

HeadlineHeadline description
AllowReturns the HTTP method used in request
Content-LengthShows the size of characters in bytes, received in the request
Content-TypeReturns the type of received request
ServerSpecifies the server from which the request comes
Access-Control-Request-MethodReturns the HTTP method that can be used in the request
Access-Control-OriginIndicates if the code that sends the request from this source can access the server response
DateShows the time of the request

Response example:

Expand
titleClick to expand...


Code Block
{
 "PersonList": [
 	{
            "Id": "188ECB8F1CEE737C-1137B5D4-E711EB11-9E4BAC0A-9C5C8E763A8FB42E999B6711",
            "Name": "Friske",
 "Surname": "Jeanna",
 "Patronymic": "",
 "Department": "Department 1",
 "Comment": "",
 "Timestamp": "2017-05-12T12:50:30.378",
 "ImageIdSurname": "1B8ECB8F1CEE737C-1137B5D4-E711EB11-9E4BAC0A-9C5C8E763A8FB42E999B6711",
    },
 {
 "Id": "148ECB8F-1137-E711-9E4B-9C5C8E763A8F",
 "Name": "Smath",
 "Surname": "William",
 "Patronymic": "",
            "Department": "Department 13",
            "Comment": "",
            "Timestamp": "20172021-0506-12T1224T06:5029:3016.368199",
            "ImageId": "158ECB8F1EEE737C-1137B5D4-E711EB11-9E4BAC0A-9C5C8E763A8FB42E999B6711",
 },
 {
 "Id": "198ECB8F-1137-E711-9E4B-9C5C8E763A8F",
 "Name": "Snipes",
 "Surname": "Wesley",
 "Patronymic": "",
 "Department": "Department 1",
 "Comment": "",
 "Timestamp": "2017-05-12T12:50:30.358",
 "ImageId": "1A8ECB8F-1137-E711-9E4B-9C5C8E763A8F"
 }
             "AutoCreated": true,
            "LastRecognitionTimestamp": "2021-06-24T06:29:28.270",
            "RecognitionCount": 1,
	}
],
 "Total": 220,
 "Response": {
 "Status": "OK"
 }


...

Using the identifier from PersonList.ImageId parameter, you can get the user's photo with a separate query. See Getting image by ID.

Response parameters:

ParameterParameter description
PersonListList of users with information from the database of persons
idReference face image User identifier from the face database
nameName
surnameSurname
patronymicPatronymic
departmentDepartment
commentComment
timestampTime of adding a face to the base of reference faces in UTC+0 format
ImageIdReference face image identifier from the face database
AutoCreated

true, if the unrecognized face was added automatically

LastRecognitionTimestamp

Time of the last pass in UTC+0 format

RecognitionCountNumber of passes
TotalTotal users in the face database
ResponseResponse
StatusCompleted request status: OK - successful, if error - see List of possible errors of the Face Recognition Server