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/zalog.php?' . http_build_query($data); $data = get_rez($url); // Результат ответа (JSON)Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
type (Метод) | Описание | Параметры в запросе |
---|---|---|
В одном запросе возможно отправить только 1 тип | По умолчанию поиск осуществляется только по актуальным сведениям из реестра уведомлений о залоге движимого имущества. | |
notary | Проверка в реестре залогов транспортного средства
• Наличие залогов
• Информация о залогах
• Залогодатели
• Залогодержатели
|
Обязательные vin - VIN номер авто и/или chassis - номер шасси и/или bodyNumber - номер кузова (минимум 1 из вариантов) Разрешено (vin): латиница, цифры, знак "-" Разрешено (chassis): латиница, цифры, знак "-", максимум 25 символов Разрешено (bodyNumber): латиница, цифры, знак "-", максимум 20 символов token - персональный ключ API Дополнительные allChanges - Осуществить поиск информации о предмете залога во всех уведомлениях о залоге, включая уведомления об изменении/исключении сведений об указанном предмете залога. Значение: 1 - включить page - Номер страницы для поиска (в диапазоне результата 'tatalPages' из ответа. Если tatalPages: 10, то page>1 и page<=10. При передаче несуществующей страницы ответ будет пустой, а запрос будет оплачен) Разрешено: цифры |
fedresurs | Проверка в реестре на нахождение транспортного средства в лизинге
• Наличие ТС в лизинге
• Информация о лизинге
• Залогодатели
• Залогодержатели
|
Обязательные vin - VIN номер авто и/или chassis - номер шасси и/или bodyNumber - номер кузова (минимум 1 из вариантов) Разрешено (vin): латиница, цифры, знак "-" Разрешено (chassis): латиница, цифры, знак "-", максимум 25 символов Разрешено (bodyNumber): латиница, цифры, знак "-", максимум 20 символов token - персональный ключ API Дополнительные allChanges - Осуществить поиск информации о предмете залога во всех уведомлениях о залоге, включая уведомления об изменении/исключении сведений об указанном предмете залога. Значение: 1 - включить page - Номер страницы для поиска (в диапазоне результата 'tatalPages' из ответа. Если tatalPages: 10, то page>1 и page<=10. При передаче несуществующей страницы ответ будет пустой, а запрос будет оплачен) Разрешено: цифры |
notaryPledgor | Проверка в реестре залогов по залогодателю
• Наличие залогов
• Информация о залогах
• Залогодатели
• Залогодержатели
|
Физические лица: Обязательные lastname - Фамилия Разрешено: кирилица, латиница, цифры, знак "-" firstname - Имя Разрешено: кирилица, латиница, цифры, знак "-" Опционально: secondname - Отчество birthdate - Дата рождения в формате дд.мм.гггг Разрешено: цифры, знак "." Юридические лица:
ОбязательныеМинимум 1 из параметров, либо все вместе: urName - Юридическое наименование Разрешено: кирилица, цифры urINN - ИНН Разрешено: цифры urOGRN - ОГРН Разрешено: цифры token - персональный ключ API Дополнительные allChanges - Осуществить поиск информации о предмете залога во всех уведомлениях о залоге, включая уведомления об изменении/исключении сведений об указанном предмете залога. Значение: 1 - включить page - Номер страницы для поиска (в диапазоне результата 'tatalPages' из ответа. Если tatalPages: 10, то page>1 и page<=10. При передаче несуществующей страницы ответ будет пустой, а запрос будет оплачен) Разрешено: цифры |
notaryPledgorFedres | Проверка в Федресурсе по залогодателю
• Наличие залогов
• Информация о залогах
• Залогодатели
• Залогодержатели
|
Физические лица: Обязательные lastname - Фамилия Разрешено: кирилица, латиница, цифры, знак "-" firstname - Имя Разрешено: кирилица, латиница, цифры, знак "-" Опционально: secondname - Отчество birthdate - Дата рождения в формате дд.мм.гггг Разрешено: цифры, знак "." Юридические лица:
ОбязательныеМинимум 1 из параметров, либо все вместе: urName - Юридическое наименование Разрешено: кирилица, цифры urINN - ИНН Разрешено: цифры urOGRN - ОГРН Разрешено: цифры token - персональный ключ API Дополнительные allChanges - Осуществить поиск информации о предмете залога во всех уведомлениях о залоге, включая уведомления об изменении/исключении сведений об указанном предмете залога. Значение: 1 - включить page - Номер страницы для поиска (в диапазоне результата 'tatalPages' из ответа. Если tatalPages: 10, то page>1 и page<=10. При передаче несуществующей страницы ответ будет пустой, а запрос будет оплачен) Разрешено: цифры |
otherNotary | Проверка иного движимого имущества
• Наличие залогов
• Информация о залогах
• Залогодатели
• Залогодержатели
|
Обязательные id - Буквенно-цифровое обозначение, идентифицирующее имущество Разрешено: латиница, цифры, знак "-" token - персональный ключ API Дополнительные allChanges - Осуществить поиск информации о предмете залога во всех уведомлениях о залоге, включая уведомления об изменении/исключении сведений об указанном предмете залога. Значение: 1 - включить page - Номер страницы для поиска (в диапазоне результата 'tatalPages' из ответа. Если tatalPages: 10, то page>1 и page<=10. При передаче несуществующей страницы ответ будет пустой, а запрос будет оплачен) Разрешено: цифры |
notification | Уведомление о "возникновении/изменении" залога
• Ссылка на скачивание документа pdf
|
Обязательные id - id из истории изменений Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
https://api-cloud.ru/api/zalog.php?type=notary&vin=WBALW31030C540031&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус ответа "num": 1, // Количество результата "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) // Массив с данными "rez": [ { // Дата записи "regDate": "11.06.2019 13:12:39", // Залогодатель "pledgors": [ { "name": "Юлия Сергеевна ********", // Имя физ лица или организации "nameDetal": "Физическое лицо", // Физическое лицо, Юридическое лицо "birthday": "1*.06.1***" // Дата рождения } ], // Залогодержатель "pledgees": [ { "name": "Общество с ограниченной ответственностью \"*********\"" } ], // Имущество "properties":[ { "vin":"XTA219070K0562441" } ], // История изменений "history": [ { "id": "2019-003-714590-094", // id "regDate": "2019-06-11T13:12:39", // Дата регистрации "regDateUnix": 1560247959, // Дата регистрации в UNIX "type": "CREATION", // Тип записи "typeTitle": "Возникновение" // Расшифровка типа записи }, { "id": "2019-003-714590-094/1", "regDate": "2021-09-23T16:32:18", "regDateUnix": 1632403938, "type": "CHANGE", "typeTitle": "Изменение" } ] } ], // Информация о запросе "inquiry": { "price": 0.8, // Списание за запрос "balance": 100462.11, // Баланс после текущего запроса "speed": 1, // Скорость запроса "attempts": 1 // Попыток } }
{ "status":200, "num":0, "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) "message":"В базе залогов не найдено", // Информация о запросе "inquiry": { "price": 0.8, // Списание за запрос "balance": 100462.11, // Баланс после текущего запроса "speed": 1, // Скорость запроса "attempts": 1 // Попыток } }
https://api-cloud.ru/api/zalog.php?type=fedresurs&vin=WBALW31030C540031&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус запроса "num": 1, // Количество записей "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) // Массив с результатми "rez": { "total": 1, // Нумерация записи "data": [ { "id": "056540000", // Номер сообщения "regDate": "2020-11-27T15:31:39.227", // Дата публикации // Имущество "properties": [ { "otherProperty": { "id": "XW8AD4NH5EK100500" } } ], // Лизингополучатели "pledgors": [ { "privatePerson": { "name": "Алексей", "birthday": "1979-11-06" }, "type": "Lessee", "publicationDisclaimer": false } ], // Лизингодатели "pledgees": [ { "organization": { "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ПЕРВЫЙ ЛИЗИНГОВЫЙ ЦЕНТР\"" }, "type": "Lessor", "publicationDisclaimer": false } ], "guid": "F2E6C6DDFE724E9191B792DDF6D9A000", "link": "/api/search/redirect/F2E6C6DDFE724E9191B792DDF6D9A000" } ] }, "inquiry": { "price": 0.6, "balance": 100462.11, // Баланс после текущего запроса "speed": 20, "attempts": 1 } }
{ "status":200, "num":0, "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) "message":"Авто в базе лизинга не найдено", // Информация о запросе "inquiry": { "price": 0.8, // Списание за запрос "balance": 100462.11, // Баланс после текущего запроса "speed": 1, // Скорость запроса "attempts": 1 // Попыток } }
https://api-cloud.ru/api/zalog.php?type=otherNotary&id=95789335&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус ответа "num": 1, // Количество результата "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) // Массив с данными "rez": [ { "regDate": "30.04.2019 21:02:30", "properties": [ { "id": "95495883" }, { "id": "95501136" }, { "id": "95501458" }, { "id": "95894150" }, { "id": "95894200" }, { "id": "95894226" }, { "id": "95895173" }, { "id": "95895181" }, { "id": "95895207" } ], "pledgors": [ { "organization": "публичное акционерное общество Государственная транспортная лизинговая компания" } ], "pledgees": [ { "name": "Акционерное общество «Всероссийский банк развития регионов»" } ], // История изменений "history": [ { "id": "2019-003-599590-282", "regDate": "2019-04-30T21:02:30", "regDateUnix": 1556647350, "type": "CREATION", "typeTitle": "Возникновение" } ], // Информация о запросе "inquiry": { "price": 0.8, // Списание за запрос "balance": 100462.11, // Баланс после текущего запроса "speed": 1, // Скорость запроса "attempts": 1 // Попыток } } ] }
https://api-cloud.ru/api/zalog.php?type=notaryPledgor&urINN=0000000000&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус ответа "num": 1, // Всего найдено записей "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) // Массив с результатами "rez": [ { "regDate": "22.06.2023 12:14:15", // Дата / время записи // Массив залогодателей "pledgors": [ { "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"АПТЕКА\"", // Наименование "nameDetal": "Юридическое лицо" // Статус } ], // Массив залогодержатели "pledgees": [ { "name": "Коммерческий банк \"Хакасский муниципальный банк\"" // Наименование } ], // Массив с залогами "properties": [ { "vin": "WDD117300000000000" }, { "vin": "WDD117300000000000" } ], // История изменений "history": [ { "id": "2023-008-105088-869", "regDate": "2023-06-22T12:14:15", // Дата / время "regDateUnix": 1687425255, // Дата / время UNIXTIME "type": "CREATION", // тип изменения "typeTitle": "Возникновение" // Расшифровка } ] } ], "inquiry": { "price": 1, "balance": 465.76, "speed": 14, "attempts": 1 } }Пример ответа по типу notaryPledgor когда нет информации формате JSON
{ "status": 200, // Статус ответа "num": 0, // Всего найдено записей "page": 0, // Текущая страница поиска "tatalPages": 0, // Всего страниц с результатами (На одной странице 10 записей) "message": "В базе залогов не найдено", // Детальный ответ "inquiry": { "price": 1, "balance": 466.76, "speed": 8, "attempts": 1 } }Ошибка! Пример ответа по типу notaryPledgor когда была передана страница (page) вне диапазона tatalPages, формате JSON
{ "status": 200, // Статус ответа "num": 96, // Всего найдено записей "page": 50, // Текущая страница поиска (ОШИБКА! Страница не в диапазоне 'tatalPages') "tatalPages": 10, // Всего страниц с результатами (На одной странице 10 записей) "rez": [], // Пустой массив "inquiry": { "price": 1, "balance": 466.76, "speed": 8, "attempts": 1 } }
https://api-cloud.ru/api/zalog.php?type=notaryPledgorFedres&urINN=0000000000&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус ответа "num": 1, // Всего найдено записей "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице) "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей) // Массив с результатами "rez": [ { "guid": "95fe0f4516000000000026fb4b594020", // id из базы Федресурса "idfedresurs": "22900000", // Номер записи в Федресурсе "regDate": "14.10.2024 15:15:39", // Дата регистрации // Массив залогодателей "pledgors": [ { "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"Тест\"", // Имя или название организации "nameDetal": "Юридическое лицо" // Статус залогодателя } ], // Массив залогодержателей "pledgees": [ { "name": "Сведения скрыты в соответствии с требованиями постановления Правительства РФ от 12.01.2018 г. №5" // Когда данные скрыты } ], "properties": [ { "id": "LB378000000S100000" } ] }, { "guid": "068c611c3c0000000000cc5d3511807", // id из базы Федресурса "idfedresurs": "16900000", // Номер записи в Федресурсе "regDate": "23.10.2023 19:48:25", // Дата регистрации // Массив залогодателей "pledgors": [ { "name": "Иван", // Имя "nameDetal": "Физическое лицо", // Статус залогодателя "birthday": "20.03.0000" // Дата рождения } ], // Массив залогодержателей "pledgees": [ { "name": "ТЕСТ ЛАРИСА ГЕННАДЬЕВНА", // Имя или название организации "ogrnip": "300006800000000" // ОГРНИП } ], Массив Имущества "properties": [ { "id": "XTAG0000000017198" } ] } ], "inquiry": { "price": 1, "balance": 465.76, "speed": 14, "attempts": 1 } }Пример ответа по типу notaryPledgorFedres когда нет информации формате JSON
{ "status": 200, // Статус ответа "num": 0, // Всего найдено записей "page": 0, // Текущая страница поиска "tatalPages": 0, // Всего страниц с результатами (На одной странице 10 записей) "message": "В базе Федресурса не найдено", // Детальный ответ "inquiry": { "price": 1, "balance": 466.76, "speed": 8, "attempts": 1 } }
https://api-cloud.ru/api/zalog.php?type=notification&id=2019-003-591110-282&token=53ba1b7a55abbB014aa97eff3a522079Пример успешного запроса по типу notification формате JSON
{ "status": 200, // Статус ответа // Ссылка с файлом для скачивания "url": "https://api-cloud.ru/notifications/5ec2f8513db5d161117b47ba27fdab09.pdf", "found": true, // Флаг найден файл "info": "Файл будет доступен по ссылке 15 минут", // Комментарий // Информация о запросе "inquiry": { "price": 0.8, // Списание за запрос "balance": 100462.11, // Баланс после текущего запроса "speed": 1, // Скорость запроса "attempts": 1 // Попыток } }Пример успешного запроса но с не существующим id по типу notification формате JSON
{ "status": 200, // Статус ответа "url": null, // null результат "found": false, // Флаг не найденного файла "info": "Указанный ID не найден", // Комментарий "inquiry": { "price": 1, "balance": 683.84, "speed": 4, "attempts": 1 } }
{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
дата | что изменилось |
---|---|
29.10.2024 | Метод: notification |
23.10.2024 | Добавлен новый метод запроса 'notaryPledgorFedres' |
23.10.2024 | Методы notary и fedresurs: |
09.10.2024 | Тип запроса 'notaryPledgor': |
26.09.2024 | notaryPledgor: Исправлено условие возникновения ошибки "ONE OF THE REQUIRED PARAMETERS IS MISSING" |
27.04.2024 | Добавлен новый метод поиска 'notaryPledgor'. Позволяет осуществить поиск по залогодателям. |
13.03.2024 | Стабилизирована и ускорена обработка всех методов запросов |
05.02.2023 | Метод запроса: notification |
23.10.2022 | В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. |
12.10.2022 | 1. Провели оптимизацию |
26.09.2022 | В документацию добавлена информация по найденным записям лизинга (type->fedresurs) |
20.06.2022 | В notary и fedresurs добавили кэширование. |
03.06.2022 | Оптимизированы алгоритмы работы |
06.05.2022 | Ускорили в разы работу. Работает быстрее и стабильнее. |
13.01.2022 | Тип запроса: notary |
06.12.2021 | Частая ошибка TIME_MAX_CONNECT. Некорректный регистр VIN параметра |
18.11.2021 | Информация о запросе в массиве inquiry |
21.10.2021 | Новые параметр в запросах "allChanges=1" |
30.09.2021 | Новые тип запроса type->notifications |
30.09.2021 | Новые данные в type->otherNotary |
30.09.2021 | Новые данные в type->notary |
27.09.2021 | Добавленый новый тип запроса type->otherNotary |
20.09.2021 | Изменены алгориты забора информации по type->fedresurs |
17.09.2021 | Восстановлена работа API. Ранее не выводило результата. |
19.04.2021 | Добавили type=fedresurs, данный тип позволяет осуществить поиск ТС в базе на наличие лизинга. |
19.04.2021 | Восстановили работоспособность модуля |
код (error) | Описание ошибки (message) |
---|---|
888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
766 | MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры |
710 | page: forbidden symbols present В параметре 'page' присутствуют запрещенные символы |
709 | MISSING PARAMETERS Не передан ни один из параметров |
708 | ONE OF THE REQUIRED PARAMETERS IS MISSING Отсутствует один из обязательных параметров |
707 | urOGRN: forbidden symbols present В параметре urOGRN присутствуют запрещенные символы |
706 | MISSING_REQUIRED_inn_PARAMETER Параметр inn передан с ошибками или не соответствует маске |
705 | urName: forbidden symbols present В параметре urName присутствуют запрещенные символы |
704 | MISSING_REQUIRED_lastname_PARAMETER Отсутствует обязательный параметр lastname |
703 | MISSING_REQUIRED_firstname_PARAMETER Отсутствует обязательный параметр firstname |
702 | secondname: forbidden symbols present В параметре secondname присутствуют запрещенные символы |
701 | lastname: forbidden symbols present В параметре lastname присутствуют запрещенные символы |
700 | firstname: forbidden symbols present В параметре firstname присутствуют запрещенные символы |
602 | TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса |
504 | TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой |
503 | TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе |
502 | MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token |
501 | MISSING_REQUIRED_VIN_PARAMETER Отсутствует параметр vin или указан неверно |
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 Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже. |
300 | MISSING_REQUIRED_ID_PARAMETER Отсутствует параметр id или указан неверно |
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"}