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/sfri.php?' . http_build_query($data); $data = get_rez($url); // Результат ответа (JSON)Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
type (Метод) | Описание | Параметры в запросе |
---|---|---|
В одном запросе возможно отправить только 1 тип | ||
auto | Проверка транспортных средств (ТС), управляемых инвалидом или используемых для перевозки инвалида
• ТС не эксплуатируется инвалидом и не используется для перевозки инвалида
• ТС эксплуатируется инвалидом или используется для перевозки инвалида
|
Обязательные regNumber - Регистрационный номер транспортного средства Разрешено для regNumber: кириллица, цифры |
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":"Повторите запрос"}
дата | что изменилось |
---|---|
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 Закончился период тестирования |
003 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
002 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
001 | API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}