Интеграция с неофициальными API таких ресурсов как: гибдд.рф, штрафы ГИБДД, РСА, ЕАИСТО, Реестр-залогов, Проверка такси, ФССП, Отзывные компании. Получение результата в удобном формате JSON.

Документация по работе с API МВД

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

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/mvd.php с персональным ключом API и параметрами.

Пример отправки GET запроса на PHP:

function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ 
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/mvd.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)

Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.

История изменений/обновлений API

Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа

type (Метод)	Описание	Параметры в запросе
	В одном запросе возможно отправить только 1 тип
chekpassport	Проверка паспорта РФ на действительность • Cреди недействительных не значится • Не действителен Не действителен (ИЗЬЯТ, УНИЧТОЖЕН) • Не действителен (ТЕХНИЧЕСКИЙ БРАК) • Не действителен (ЗАМЕНЕН НА НОВЫЙ) • Не действителен (УТРАТА ПАСПОРТА) • Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)	Обязательные seria - Серия паспорта Разрешено: цифры nomer - Номер паспорта Разрешено: цифры token - персональный ключ API

Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.

Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

Примеры запросов

Проверка паспорта на действительность

Пример запроса "Проверка паспорта на действительность" HTTP GET на URL нашего API

https://api-cloud.ru/api/mvd.php?type=chekpassport&seria=0*14&nomer=25**55&token=53ba1b7a55abbB014aa97eff3a522079

Есть данные о паспорте

// Среди недействительных не значится
{
  "status": 200,
  // Результат: 0 не значится среди недействительных
  "rezultat": 0,
  "info": "По Вашему запросу о действительности паспорта РФ 0*14 № 25**55 получен ответ о том, что данный паспорт «Cреди недействительных не значится».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

// Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)
{
  "status": 200,
  // Результат: 1 значит Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)
  "rezultat": 1,
  "info": "По Вашему запросу о действительности паспорта РФ 0000 № 000000 получен ответ о том, что данный паспорт «Не действителен Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

// Не действителен (ТЕХНИЧЕСКИЙ БРАК)
{
  "status": 200,
  // Результат: 2 значит Не действителен (ТЕХНИЧЕСКИЙ БРАК)
  "rezultat": 2,
  "info": "По Вашему запросу о действительности паспорта РФ 0000 № 000000 получен ответ о том, что данный паспорт «Не действителен (ТЕХНИЧЕСКИЙ БРАК)».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

// Не действителен (ЗАМЕНЕН НА НОВЫЙ)
{
  "status": 200,
  // Результат: 3 значит Не действителен (ЗАМЕНЕН НА НОВЫЙ)
  "rezultat": 3,
  "info": "По Вашему запросу о действительности паспорта РФ 4103 № 118993 получен ответ о том, что данный паспорт «Не действителен (ЗАМЕНЕН НА НОВЫЙ)».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

// Не действителен (УТРАТА ПАСПОРТА)
{
  "status": 200,
  // Результат: 4 значит Не действителен (ЗАМЕНЕН НА НОВЫЙ)
  "rezultat": 4,
  "info": "По Вашему запросу о действительности паспорта РФ 4103 № 118993 получен ответ о том, что данный паспорт «Не действителен (ЗАМЕНЕН НА НОВЫЙ)».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

// Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)
{
  "status": 200,
  // Результат: 5 значит Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)
  "rezultat": 5,
  "info": "По Вашему запросу о действительности паспорта РФ 4103 № 118993 получен ответ о том, что данный паспорт «Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

// Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)
{
  "status": 200,
  // Результат: 5 значит Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)
  "rezultat": 6,
  "info": "По Вашему запросу о действительности паспорта РФ 4508 № 481275 получен ответ о том, что данный паспорт «Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)».",
  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Возможные безрезультативные ответы

// При попытке отправить итоговый запрос мы получили ответ, что источник недоступен
{"status":404,"error":9000,"message":"Ресурс источник недоступен"}

// Источник доступен, но ответ ресурса выходит за задокументированные рамки
{"status":404,"error":1,"message":"Нет ответа от ресурса источника"}

// Источник доступен, но в решении капчи допущена ошибка
{"status":404,"error":1,"message":"Незадокументированный ответ источника. Возможно не верно были переданы seria или nomer"}

История изменений API МВД

дата	что изменилось
11.08.2023	API запущен по архивному поиску по БД (данные с официального источника) до момента официального запуска источника. Напоминаем, что ресурс МВД приостановил онлайн проверку по недействительным паспортам ввиду начавшейся путаницы в базе, теперь он восстанавливает и проверяет данные. Как только он заработает мы переключимся на онлайн проверку.
14.07.2023	Добавили вывод ошибки когда источник становится не доступен. Средства за такие запросы не списываются. {"status":404,"error":9000,"message":"Ресурс источник недоступен"}
28.12.2022	1. Установили фильтрацию входящих параметров seria и nomer 2. Переработали алгоритм работы.
28.10.2022	Проведена оптимизация, исплавлены баги, которые вызывали ошибку таймаута.
23.10.2022	В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса.
05.03.2022	Добавлены попытки получить результат в случае неудачи. Исправлены мелкие баги.
18.02.2022	Стабилизировали работу. Переделан алгоритм получения информации, который позволил уменьшить количество ошибок "Повторите запрос"
26.01.2022	Новый результат В вывод добавлен новый результат "Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)"
21.01.2022	Новый результат В вывод добавлен новый результат "Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)"
13.01.2022	Новый результат В вывод добавлен новый результат "Не действителен (УТРАТА ПАСПОРТА)"
18.11.2021	Информация о запросе в массиве inquiry Добавлен статус ответа, а так же информация о запросе: Тариф, скорость, количество попыток

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

код (error)	Описание ошибки (message)
9000	Ресурс источник недоступен Ресурс источник недоступен. Повторите запрос позже.
888	ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы
766	MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры
602	TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса
504	TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой
503	TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе
502	MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token
500	MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
1000	MISSING_MANDATORY_PARAMETERS Отсутствуют обязательные параметры
015	DATE_ERROR Ошибка значения переданной даты
005	TEST_TIME_OFF Закончился период тестирования
003	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
002	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
001	API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

Пример ответа с ошибкой

{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}