Перейти к основному содержимому
Версия: 1.5.0

Работа с черными списками

Черные списки BAF — это механизм контроля доступа к ресурсам заказчика исключительно для верифицированных пользователей.

Управление черными списками включает возможность получения информации о пользователе, а также редактирования и удаления данных пользователя.

Добавление персоны в черный список

Эндпоинт POST /publicapi/api​/v2​/private​/Blacklist

Пример запроса:

{
"firstName": "Bob",
"middleName": "Jamesbob",
"familyName": "Familybob",
"dob": "2023-06-22T13:57:35.163Z"
}

Пример ответа:

Status Code200
{
"data": "e8f42***", // personId
"succeeded": true,
"isError": false,
"errors": []
}

Возможные ошибки:

CodeMessageDescriptionCode
400The Dob is emptyDate of birth field in request body is empty120034
400Values "field names" are emptyFirst name, last name or middle name is empty120034
400BlacklistPerson already existsBlacklistPerson with such data already exists120035

После добавления в черный список пользователю с такими данными будет отказано в доступе.

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

Чтобы получить актуальный черный список пользователей, необходимо отправить запрос на эндпоинт с возможностью фильтрации.

Эндпоинт GET /publicapi/api​/v2​/private/Blacklist

Название поляОписаниеЗначение
PageНомер страницыОт 1 до 2147483647
PageSizeМаксимальное количество аппликантов на страницеОт 1 до 400

Для поиска и сортировки можно использовать следующие поля:

Название поляОписание
SortFieldПоле для сортировки. Можно указать firstName, lastName, phone и т.д.
OrderПорядок сортировки для выбранного поля. Для порядка по убыванию укажите значение: descending. Порядок по возрастанию задан по умолчанию.
TextFilterТекстовый поиск.

Пример запроса:

curl -X 'GET' \
'https://baf.3divi.ai/publicapi/api/v2/private/Blacklist?Page=1&PageSize=10' \
-H 'accept: text/plain' \
-H 'Authorization: Bearer sk_3938***'

Пример ответа:

Status Code200
{
"data": {
"page": 1,
"pageSize": 10,
"total": 1,
"totalPages": 1,
"items": [
{
"id": "e8f4***",
"firstName": "BOB",
"middleName": "JAMESBOB",
"familyName": "FAMILYBOB",
"dob": "2023-06-22T13:57:35.163"
}
]
},
"succeeded": true,
"isError": false,
"errors": []
}

Возможные ошибки:

CodeMessageDescriptionCode
400No sorting by selected property.Wrong sorting field selected120026

Добавление аппликанта в черный список

Эндпоинт POST /publicapi/api​/v2​/private/Blacklist/FromApplicantId

Тело запроса:

{
"applicantId": "string"
}

Пример запроса:

curl -X 'POST' \
'https://baf.3divi.ai/publicapi/api/v2/private/Blacklist/FromApplicantId' \
-H 'accept: text/plain' \
-H 'Authorization: Bearer sk_3938***' \
-H 'Content-Type: application/json' \
-d '{
"applicantId": "9687***"
}'

Пример ответа:

Status Code200
3fa85*** // personId

Получение информации о персоне из черного списка

Эндпоинт GET /publicapi/api​/v2​/private/Blacklist/{personId}

Параметры:

personId — ID персоны

Пример запроса:

curl -X 'GET' \
'https://baf.3divi.ai/publicapi/api/v2/private/Blacklist/3fa85***' \
-H 'accept: text/plain' \
-H 'Authorization: Bearer sk_3938***'

Пример ответа:

Status Code200
{
"id": "3fa85***",
"applicantId": "3fa85f6***",
"firstName": "string",
"middleName": "string",
"familyName": "string",
"dob": "2023-09-21T16:40:58.882Z"
}

Изменение информации о персоне из черного списка

Эндпоинт PUT /publicapi/api​/v2​/private/Blacklist/{personId}

Параметры:

personId — ID персоны

Тело запроса:

{
"firstName": "string",
"middleName": "string",
"familyName": "string",
"dob": "2023-09-21T16:44:32.658Z"
}

Пример запроса:

curl -X 'PUT' \
'https://baf.3divi.ai/publicapi/api/v2/private/Blacklist/9687***' \
-H 'accept: */*' \
-H 'Authorization: Bearer sk_3938***' \
-H 'Content-Type: application/json' \
-d '{
"firstName": "string",
"middleName": "string",
"familyName": "string",
"dob": "2023-09-21T16:44:32.658Z"
}'

Пример ответа:

Status Code200

Удаление персоны из черного списка

Эндпоинт DELETE /publicapi/api​/v2​/private/Blacklist/{personId}

Параметры:

personId — ID персоны

Пример запроса:

curl -X 'DELETE' \
'https://baf.3divi.ai/publicapi/api/v2/private/Blacklist/9687***' \
-H 'accept: */*' \
-H 'Authorization: Bearer sk_3938***'

Пример ответа:

Status Code200