Получить список персон из указанного списка

POST /persons

Описание

Метод возвращает список персон из заданного списка пользователя (по умолчанию или указанного). Для доступа необходим JWT-токен в заголовке.

Формат запроса

HTTP метод: POST
URL: /persons
Тип контента: application/json
Авторизация: требуется

Параметры запроса

Параметр	Тип	Где передаётся	Обязательный	Описание
token	string	Header	✅	JWT-токен пользователя

Тело запроса (JSON)

Поле	Тип	Обязательный	Описание
token	string	✅	JWT-токен пользователя
list_id	string	✅	Идентификатор списка персон
limit	integer	❌	Максимальное количество возвращаемых записей
cursor	string	❌	Курсор для постраничного вывода
thumbs	bool	❌	Вернуть ли миниатюры изображений
embeddings	bool	❌	Вернуть ли эмбеддинги

Пример запроса (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/persons" 
  -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
  }'

Примеры ответов

Успех (200 OK)

{
  "status": "ok"
}

Ошибка (400 Bad Request)

{
  "message": "invalid schema",
  "status": "error"
}

Ошибка (401 Unauthorized)

{
  "message": "access denied",
  "status": "error"
}

Ошибка (404 Not Found)

{
  "message": "item with this id does not found",
  "status": "error"
}