> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/acs-configuration/chernyi-spisok.md).

# Черный список

**Интеграция с внешним сервисом проверки по чёрному списку**

PassOffice при создании или редактировании человека **обращается к указанному вами внешнему URL**, чтобы проверить его по вашему собственному чёрному списку.

**Что должен реализовать клиент**

Реализовать собственный HTTP-обработчик, который будет принимать запросы от PassOffice и возвращать результат проверки в строго заданном формате.

**1. Проверка по ФИО и документу**

**Метод:** POST

**URL:** \<URL\_из\_настроек\_интеграции>/check

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

```json
{
  "name": "Петр",
  "surname": "Петров",
  "middlename": "Петрович",
  "phone": "+79991231234",
  "birthday": "1985-06-15",
  "documentType": "PASSPORT_RF",     // или "OTHER"
  "documentSeries": "2415",
  "documentNumber": "123123"
}
```

**Ожидаемый ответ (JSON):**

```json
{
  "found": true,
  "comments": [
    "Статья УК РФ 123", 
    "Статья УК РФ 124"]
}
```

* `found: true` — человек найден в чёрном списке
* `comments` — список комментариев (причины блокировки), которые будут **отображаться в PassOffice** на форме человека.

**2. Проверка доступности сервиса (пинг)**

**Метод:** GET

**URL:** \<URL\_из\_настроек\_интеграции>/ping

**Ожидаемый ответ:** HTTP-статус **200 OK.**