Инфорадар.Паспорт

Сервис проверки действительности паспортов предназначен для проверки легитимности паспорта с минимальным набором данных, что особенно актуально для организаций, работающих с клиентами, требующими подтверждения своей личности.

Сервис решает несколько ключевых задач:

Упрощение процессов: сервис позволяет пользователям быстро проверить действительность паспорта, направив минимальный набор данных: фамилию, имя, серию и номер паспорта.
Повышение безопасности: для организаций, работающих с клиентами, проверка паспорта помогает избежать потенциальных рисков, связанных с мошенничеством, подделкой документов и другими правонарушениями.
Доступность информации: пользователи могут в любое время получить информацию о действительности паспорта.
Экономия времени и ресурсов: благодаря автоматизированной проверке паспортов компании могут сократить время на обработку документов и снизить затраты на трудозатраты сотрудников.

Атрибут	Значение
Название	rpa-really-passports
Тип	Адаптер для взаимодействия с сервисом проверки паспортов
Наименование	Проверка действительности паспорта
Версия	Реализовано 24.03.2025

Сервис является частью платформы Агредатор. Перед изучением данной документации ознакомьтесь со следующими обязательными документами по интеграции с платформой:

Принимаемые параметры

Параметр	Название	Обязательное	Пример
service	Название сервиса	+	rpa-really-passports
client_id	Идентификатор ЭЦП контейнера клиента	+	client_id
series	Серия паспорта	+	6011
number	Номер паспорта	+	620817
firstname	Имя	+	Иван
lastname	Фамилия	+	Иванов

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

Параметр	Название	Обязательное	Пример
result_status	Статус результата	+	Могут быть только 3 значения: :entity_not_found, :valid, :invalid.

Примеры

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

{
  "service": "rpa-really-passports",
  "client_id": "client_id",
  "series": "6011",
  "number": "620891",
  "firstname": "Иван",
  "lastname": "Иванов"
}

Если не удалось найти клиента с такими данными, то в ответе будет entity_not_found. Если паспорт действителен, то будет valid; если не действителен - invalid, например:

{
  "result_status": "entity_not_found"
}

Производительность и ограничения

Каждый запрос на проверку паспорта обрабатывается последовательно и занимает от 15 секунд. При одновременной отправке большого числа запросов общее время обработки увеличивается пропорционально количеству запросов.

Кол-во запросов	Время обработки
1 запрос	~15 секунд
1000 запросов	~15 000 секунд (около 4 часов)

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

Набор HTTP-запросов

Файл набора HTTP-запросов - это файл, созданный в приложении Postman, который содержит набор HTTP-запросов, ответов и сопутствующей информации, связанной с тестированием API.

Коллекция в Postman обычно включает в себя следующую информацию:

HTTP-запросы: GET, POST, PUT, DELETE и другие типы запросов.
Параметры запросов: параметры пути, параметры запроса, тело запроса, заголовки запроса и другие параметры.
Ожидаемые ответы: коды ответов, тела ответов и заголовки ответов.
Тесты: наборы скриптов, которые используются для проверки правильности ответов на запросы.
Переменные: значения переменных, которые могут использоваться в разных запросах, чтобы избежать повторений.