Документация
Подключение
Задать вопрос и получить token для подключения к API, Вы можете отправив электронное письмо на адрес: [email protected]
Скачать PHP скрипт для Вашего сайта.
Обязательные параметры
При передачи запроса должны быть указаны обязательные параметры подключения к базе:
- URL: Token
- URL: Серия и номер паспорта в формате 10 цифр. (&ser_num=1122333333 или &ser_num=11 22 333333)
- CURL: USERAGENT: CCBot/2.0 (https://commoncrawl.org/faq/)
Ответ
При успешном подключении параметры ответа:
token
- domain - Адрес домена (если привязан)
- status - Статус подключения к token
- count - Колличество успешных запросов (только при получении результата)
balance
- price - Стоимость запроса
- current - Баланс до совершения запроса
- residue - Текущий баланс (остаток)
error
- code - Код ошибки
- text - Описание пролемы подключения
result
- ser - Серия паспорта (11 22)
- num - Номер паспорта (000000)
- full - Серия и номер паспорта без пробелов (1122000000)
- region - Республика, край, область или округ где был выдан паспорт
- year - Дата выдачи (в фомате 2022)
- valid - Результат запроса из списка недействительных паспортов РФ
true - не найден (считается как действительный)
false - найден (недействительный)
Пример успешного ответа
https://passport-api.ru/api/1.0/result.php?token=test&ser_num=1122345678
https://passport-api.ru/api/1.0/result.php?token=test&ser_num=11 22 345678
Пример ответа с ошибкой
https://passport-api.ru/api/1.0/result.php?token=test&ser_num=110012345
https://passport-api.ru/api/1.0/result.php?token=test&ser_num=text
Ограничения
Ограничения по запросам к базе имеет только форма на главной странице.
Подключение
Задать вопрос и получить token для подключения к API, Вы можете отправив электронное письмо на адрес: [email protected]
Обязательные параметры
При передачи запроса должны быть указаны обязательные параметры подключения к базе:
- URL: Token
- URL: Код подразделения в формате 6 цифр. (&code=000111)
- CURL: IP адрес сервера (с которого будет отправлен запрос)
- CURL: Адрес доменного имени (https://test.ru/ или test.ru)
- CURL: USERAGENT (например: CCBot/2.0 (https://commoncrawl.org/faq/))
Ответ
При успешном подключении параметры ответа:
token
- domain - Адрес домена (если привязан)
- status - Статус подключения к token
- count - Колличество успешных запросов (только при получении результата)
balance
- price - Стоимость запроса
- current - Баланс до совершения запроса
- residue - Текущий баланс (остаток)
error
- code - Код ошибки
- text - Описание пролемы подключения
result
- text - Наименование отделения УФМС России
- datestamp - Дата актуальности
Пример успешного ответа
https://passport-api.ru/api/1.0/result.php?token=test&code=000111
Пример ответа с ошибкой
https://passport-api.ru/api/1.0/result.php?token=test&code=0001
https://passport-api.ru/api/1.0/result.php?token=test&code=11-22
https://passport-api.ru/api/1.0/result.php?token=test&code=000-111
https://passport-api.ru/api/1.0/result.php?token=test&code=all_text
Ограничения
Ограничения по запросам к базе имеет только форма на главной странице.
Подключение
Обслуживание доступно только для юридических лиц (действует упрощенная форма взаимодействия). По всем вопросам подключения вы можете обратиться к нашему менеджеру: [email protected]
Кодировка
UTF-8
Метод
GET
Обязательные параметры
При передачи запроса должны быть указаны обязательные параметры подключения к базе:
- URL: Token
- URL: Тип документа. (&inn=21)
- URL: Фамилия Имя Отчество. (&fio=Иванов Иван Иванович)
- URL: Дата рождения. (&birthdate=29.01.2022 или UNIX формат)
- URL: Серия и номер паспорта. (&docnum=0123456789 / &docnum=01 23 456789 / &docnum=0123 456789)
- URL: Дата выдачи паспорта. (&docdt=22.12.2020 или UNIX формат)
- URL: Код подразделения. (&dcode=000-123 / &dcode=000123)
- CURL: IP адрес сервера (с которого будет отправлен запрос)
- CURL: Адрес доменного имени (https://test.ru/ или test.ru)
- CURL: USERAGENT (например: CCBot/2.0 (https://commoncrawl.org/faq/))
Ответ
При успешном подключении параметры ответа:
token
- domain - Адрес домена (если привязан)
- status - Статус подключения к token
- count - Количество выполненных запросов
balance
- price - Стоимость запроса
- current - Баланс до совершения запроса
- residue - Текущий баланс (остаток)
error
- code - Код ошибки
- text - Описание проблемы подключения
result
- request_id - Уникальный номер запроса
- inn - ИНН (12 цифр: 447598131671)
- info - Информация (если ИНН не найден)
- address - Если в запросе указан адрес прописки
- request - Адрес для запроса
- fias - Полный адрес ФИАС
Пример успешного ответа
Список ошибок
- 100 - Сервер временно недоступен.
- 200 - Запрос успешно выполнен.
- 201 - Запрос успешно выполнен (ИНН не найден)
- 206 - Данный токен не предназначен для текущего запроса.
- 207 - Ошибка в данных или паспорт находится в списке недействительных.
- 500 - Баланс менее стоимости запроса.
Примечание
Столкнулись с проблемой, сообщите нам об этом на эл.почту: [email protected]