rkl — Проверка по реестру контролируемых лиц¶

POST https://api.newdb.net/v2

Метод выполняет проверку лица по форме сервиса Госуслуг "Реестр контролируемых лиц".

Связанные страницы¶

Когда использовать¶

Используйте метод, когда нужно проверить присутствие иностранного гражданина в реестре контролируемых лиц МВД РФ по реквизитам документа и дате рождения.

Типовые кейсы¶

Проверка статуса иностранного гражданина перед трудоустройством
Миграционный аудит в HR или compliance-процессе
Автоматическая проверка мигрантов по реквизитам документа и дате рождения

Заголовки¶

Content-Type: application/json
X-API-KEY: <your_token>

Пример параметров запроса (`params`)¶

Ниже пример в формате, который передается в сервис:

params_raw = json.dumps({
    "method": "rkl",
    "country": "ru",
    "dob_info": "19.10.1995",
    "issue_date": "08.06.2023",
    "id_doc_number": "7887320",
    "id_doc_seria": "FA",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003"
})

Для dob_info = "19.10.1995" spider выберет режим полной даты рождения (optional = "1"), поле заполнится значением 19.10.1995.

Пример API-запроса (без серии документа)¶

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

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "dob_info": "19.10.1995",
    "issue_date": "08.06.2023",
    "id_doc_number": "7887320",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003"
  },
  "requestId": "optional-string",
  "webhook": "https://your.host/webhook"
}

Пример API-запроса (`dob_info` = только год)¶

Для dob_info = "1995" spider выберет режим "Только год" (optional = "2"), в форме будет выбран год 1995.

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "dob_info": "1995",
    "issue_date": "08.06.2023",
    "id_doc_seria": "FA",
    "id_doc_number": "7887320",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003-year"
  },
  "requestId": "optional-string",
  "webhook": "https://your.host/webhook"
}

Пример API-запроса (`dob_info` = полная дата)¶

Для dob_info = "19.10.1995" spider выберет режим "Полная дата" (optional = "1").

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "dob_info": "19.10.1995",
    "issue_date": "08.06.2023",
    "id_doc_seria": "FA",
    "id_doc_number": "7887320",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003-full-date"
  },
  "requestId": "optional-string",
  "webhook": "https://your.host/webhook"
}

Входные параметры (`params`)¶

{
  "method": "rkl",
  "country": "ru",
  "dob_info": "string",
  "issue_date": "string",
  "id_doc_number": "string",
  "id_doc_seria": "string",
  "taskId": "string"
}

Основные поля:

id_doc_number — номер документа (обязательное поле).
issue_date — дата выдачи документа (обязательное поле, формат DD.MM.YYYY или YYYY-MM-DD).
dob_info — дата рождения в полном или частичном формате (обязательное поле).
id_doc_seria — серия документа (необязательное поле).

`dob_info`: как парсится¶

Поле dob_info поддерживает несколько форматов. По нему spider определяет, какой режим даты рождения выбрать в форме.

Поддерживаемые форматы:

DD.MM.YYYY (также допускаются разделители -, /) -> полная дата рождения.
MM.YYYY (также MM-YYYY, MM/YYYY) -> месяц и год рождения.
YYYY -> только год рождения.
YYYY.MM / YYYY-MM / YYYY-MM-DD /YYYY/MM -> также принимается для обратной совместимости и трактуется как год+месяц.

Примеры¶

dob_info = "10.1995" -> режим "Месяц и год", в форме: Окт 1995
dob_info = "1995" -> режим "Только год", в форме: 1995
dob_info = "19.10.1995" -> режим "Полная дата", в форме поле даты: 19.10.1995

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

Ниже пример структуры ответа NEWDB для метода rkl. Значение registry_status определяется из текста результата на экране Госуслуг:

not_found — если в заголовке найдено "отсутствует в реестре контролируемых лиц"
found — если в заголовке найдено "в реестре контролируемых лиц"
unknown — если статус не удалось определить по заголовку

{
  "params": {
    "params": {
      "method": "rkl",
      "country": "ru",
      "dob_info": "19.10.1995",
      "issue_date": "08.06.2023",
      "id_doc_number": "7887320",
      "newdb_qid": "EKYiIMO21ZnJMygA",
      "taskId": "test-rkl-003"
    }
  },
  "requestId": "optional-string",
  "state": "complete",
  "results": {
    "rkl": {
      "taskId": "test-rkl-003",
      "dateupdated": "2026-08-31 16:47:00",
      "result": {
        "status": 200,
        "data": [
          {
            "title": "Отсутствует в реестре контролируемых лиц",
            "details": [
              "Документ: 7887320, выдан 08.06.2023",
              "Дата рождения: 19.10.1995",
              "Данные получены из системы МВД России",
              "31.08.2026 16:47 МСК"
            ],
            "raw": "Отсутствует в реестре контролируемых лиц Документ: 7887320, выдан 08.06.2023 Дата рождения: 19.10.1995 Данные получены из системы МВД России 31.08.2026 16:47 МСК",
            "registry_status": "not_found"
          }
        ],
        "screen_url": "https://api.newdb.net/v2/screen?request_id=b114bbb2-f3f6-1051-4dac-c8bb6f2533ec"
      }
    }
  }
}

Получение скриншота проверки (`get_screen`)¶

Метод поддерживает создание снимка экрана официального ответа сервиса Госуслуг в момент выполнения проверки.

1. Как включить создание скриншота¶

Для получения снимка экрана добавьте параметр "get_screen": 1 (или "get_screen": true) в объект params:

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "dob_info": "19.10.1995",
    "issue_date": "08.06.2023",
    "id_doc_number": "7887320",
    "get_screen": 1
  }
}

2. Защищенная ссылка на скриншот¶

После завершения проверки в структуре results.rkl.result возвращается защищенная ссылка screen_url:

"screen_url": "https://api.newdb.net/v2/screen?request_id=b114bbb2-f3f6-1051-4dac-c8bb6f2533ec"

Скриншоты хранятся в защищенном хранилище и доступны только авторизованным пользователям по API-токену.

3. Как открыть или скачать скриншот¶

Получить изображение в формате PNG можно двумя способами:

Способ А: Запрос с заголовком авторизации (рекомендуется для бекенда)¶

curl -H "X-API-KEY: YOUR_API_TOKEN" \
  "https://api.newdb.net/v2/screen?request_id=b114bbb2-f3f6-1051-4dac-c8bb6f2533ec" \
  --output rkl_screenshot.png

Способ Б: Запрос с токеном в параметрах URL (для браузера и Mini App)¶

https://api.newdb.net/v2/screen?request_id=b114bbb2-f3f6-1051-4dac-c8bb6f2533ec&token=YOUR_API_TOKEN

При обращении эндпоинт возвращает бинарные данные PNG-изображения с заголовком Content-Type: image/png.

AI Summary¶

Компактные метаданные для AI и агентных систем

{
  "method": "rkl",
  "intent": "Проверка наличия в реестре контролируемых лиц",
  "endpoint": "POST https://api.newdb.net/v2",
  "required_headers": ["X-API-KEY"],
  "required_fields": ["dob_info", "issue_date", "id_doc_number", "method", "country"],
  "optional_fields": ["id_doc_seria"],
  "returns": ["state", "results.rkl.result.status", "results.rkl.result.data", "results.rkl.result.screen_url"]
}