Документация по работе с API Федеральный реестр инвалидов
Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/sfri.php с персональным ключом API и параметрами.
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON
Базовая цена запроса: 0.5 руб.
История изменений/обновлений
| type (тип) | Описание | Параметры в запросе |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| auto | Проверка транспортных средств (ТС), управляемых инвалидом или используемых для перевозки инвалида
• ТС не эксплуатируется инвалидом и не используется для перевозки инвалида
• ТС эксплуатируется инвалидом или используется для перевозки инвалида
|
Обязательные regNumber - Регистрационный номер транспортного средства Разрешено для regNumber: кириллица, цифры |
Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.
Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
Примеры запросов
Проверка транспортных средств (ТС), управляемых инвалидомили используемых для перевозки инвалида
Пример запроса "Проверка транспортных средств (ТС), управляемых инвалидомили используемых для перевозки инвалида" HTTP GET на URL нашего API
https://api-cloud.ru/api/sfri.php?type=auto®Number=T111OH111&token=53ba1b7a55abbB014aa97eff3a522079
ТС эксплуатируется инвалидом или используется для перевозки инвалида
{
"status": 200,
"rezultat": 1,
"info": "ТС эксплуатируется инвалидом или используется для перевозки инвалида",
"inquiry": {
"price": 0.5,
"balance": 100462.11, // Баланс после текущего запроса
"speed": 6,
"attempts": 1
}
}
ТС не эксплуатируется инвалидом и не используется для перевозки инвалида
{
"status": 200,
"rezultat": 0,
"info": "ТС не эксплуатируется инвалидом и не используется для перевозки инвалида",
"inquiry": {
"price": 0.5,
"balance": 100462.11, // Баланс после текущего запроса
"speed": 6,
"attempts": 1
}
}
Возможные безрезультативные ответы
// При попытке отправить итоговый запрос мы получили ответ, что источник недоступен
{"status":404,"error":1,"message":"Ресурс источник недоступен"}
// Источник доступен, но ответ ресурса выходит за задокументированные рамки
{"status":404,"error":1,"message":"Нет ответа от ресурса источника"}
// Источник доступен, но в решении капчи допущена ошибка
{"status":404,"error":1,"message":"Повторите запрос"}
История изменений API Федеральный реестр инвалидов
| дата | что изменилось |
|---|---|
| 02.11.2022 | Фикс ошибки "Повторите запрос" |
| 23.10.2022 | В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. |
Возможные коды ошибок
| код (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, что-то одно. |
| 015 | DATE_ERROR Ошибка значения переданной даты |
| 005 | TEST_TIME_OFF Закончился период тестирования |
| 001 | API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}
• API ГИБДД (Государственная инспекция безопасности дорожного движения)
• API Федеральная Таможенная Служба (ФТС)
• API VIN Декодер (Расшифровка данных VIN номера)
• API РСА (Российский Союз Автостраховщиков)
• API ЕАИСТО (Единая Автоматизированная Информационная система технического осмотра)
• API ФССП (Федеральная Служба Судебных Приставов)
• API Отзывные компании
• API Проверка ТС по базе такси
• API Фотографии транспортных средств
• API Каталог фотографий авто
• API Оценка стоимости автомобиля
• API МВД (Министерство Внутренних дел)
• API ФРИ (Федеральный реестр инвалидов)
• API Федеральная налоговая служба
• API Московский транспорт (transport.mos.ru)
• API Федеральный ресурс (Банкротства)
• API Росреестр
• API Bidcars (История автомобилей из США с аукционов Copart и IAAI)
• API Электронный ПТС
• API Номерограм
• API Скриншот сайта
• API Росфинмониторинг
• API Конвертер VIN<->Рег.номер
• API API ras.arbitr (Решения арбитражных судов)
• API kad.arbitr (Картотека арбитражных дел)
• API Реестр залогов
Обращаем ваше внимание, что API-CLOUD не имеет никакого отношения к ресурсам источникам*, а предоставляет вам более удобный способ взаимодействия с информацией, находящейся в открытом доступе на данных ресурсах.
