POST /person
Description
The method returns data about a person from a given list (default or specified). A JWT token is required in the header for access.
Request format
- HTTP method:
POST - URL:
/person - Content type:
application/json - Authorization: required
Query Parameters
| Parameter | Type | Where passed | Required | Description |
|---|---|---|---|---|
| token | string | Header | ✅ | User’s JWT token |
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| token | string | ✅ | User’s JWT token |
| list_id | string | ✅ | Person list ID |
| limit | integer | ❌ | Maximum number of records to return |
| cursor | string | ❌ | Cursor for pagination |
| thumbs | bool | ❌ | Return image thumbnails |
| embeddings | bool | ❌ | Return embeddings |
Example Request (cURL)
curl -X POST "https://api.neuro-vision.ru/v1/person"
-H "Content-Type: application/json"
-H "Authorization: Bearer jwt.temporary.token"
-d '{
"token": "jwt.temporary.token",
"list_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"limit": 10,
"cursor": "",
"thumbs": true,
"embeddings": true
}'Example Answers
Success (200 OK)
{
"created": "2023-10-17T09:30:47Z",
"features": {
"eye_distance": 63,
"eye_left": [10, 20],
"eye_right": [73, 20],
"gender": "male",
"glasses": "none",
"yaw": 0,
"pitch": 0,
"roll": 0,
"facial_hair": "none"
},
"fields": [
"Jim",
"Carry",
"21 Solter street",
"New York"
],
"group_id": "a53910d3-44c6-40a7-98f0-0a93772495fa",
"image_url": "https://api.enface.ai/images/7114d3d0-94a0-11ea-930e-d601cafe23fd/random/token",
"list_id": "1ad22a7e-e5de-4a50-b066-d9f00f81ff5f",
"person_id": "55e2c7d0-951c-11ea-83be-36b62cef36f0",
"source_id": "ccf4c6ca-95f3-4d73-8819-13918497e59e",
"status": "init",
"yaw": 45
}Error (400 Invalid schema)
{
"message": "item with this id not found",
"status": "error"
}Error (401 Unauthorized request)
{
"message": "access denied",
"status": "failed"
}Error (404 Invalid schema)
{
"message": "item with this id not found",
"status": "error"
}