Удалить персону по идентификатору (или нескольким)

POST /person/delete

Описание

Метод удаляет одну или несколько персон из указанного списка по идентификатору. Для доступа нужен токен, см. раздел «Авторизация».

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

  • HTTP метод: POST
  • URL: /person/delete
  • Тип контента: application/json

Авторизация

Токен передаётся одним из способов:

  • заголовок token: <jwt-token> — временный JWT-токен, полученный методом user/login;
  • поле token в теле запроса — постоянный API-токен (UUID) из личного кабинета.

Без токена запрос вернёт 401 access denied.

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

ПолеТипОбязательныйОписание
tokenstring—Постоянный API-токен (UUID), если нет заголовка token
list_idstring✅Идентификатор списка персон
person_idstring[]✅Массив идентификаторов персон

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

curl -X POST "https://api.neuro-vision.ru/v1/person/delete" -H "Content-Type: application/json" -H "token: <jwt-token>" -d '{"list_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "person_id": ["75e55780-8943-11ea-9773-e96daa282099", "51b755a0-8c02-11ea-830b-5a7682ee42b9"]}'

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

Успех (200 OK)

{
  "message": "1 person(s) deleted",
  "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 not found",
  "status": "error"
}