API Реестр залогов

Документация по работе с API Реестр залогов (reestr-zalogov.ru)

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

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

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

HTTPS GET запрос: https://api-cloud.ru/api/zalog.php
Обязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS.
Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.

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 из истории изменений (формат 2024-000-000000-420 или 2024-000-000000-420/1) Разрешено: латиница, цифры, знаки "- /" token - персональный ключ API

Токен (token) можно передавать в заголовках (headers). Указываем в заголовке Token: ВАШ_ТОКЕН

Пример отправки 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/zalog.php?' . http_build_query($data);

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

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

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

Проверка залогов по VIN номеру

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

https://api-cloud.ru/api/zalog.php?type=notary&vin=WBALW31030C540031&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу notary с сайта Реестр залогов в формате JSON

{
  "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***" // Дата рождения
		  
        },
        {
          "name": "Юлия Сергеевна ********", // Имя физ лица или организации
		      "nameDetal": "Индивидуальный предприниматель", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "ogrnip": "XXXXXXXXXXXXXX" // ОГРНИП
		  
        },
        {
          "name": "ООО НАЗВАНИЕ", // Имя физ лица или организации
		      "nameDetal": "Юридическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
		  
        } 
      ],
	  // Залогодержатель
      "pledgees": [
        {
          "name": "Общество с ограниченной ответственностью \"*********\"",
          "nameDetal": "Юридическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
        }
      ],
	  // Имущество
	  "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, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если в залогах vin номер не найден

{
	"status":200,
	"num":0,
  "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице)
  "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей)
	"message":"В базе залогов не найдено",
	// Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Проверка на наличие ТС в лизинге по VIN номеру

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

https://api-cloud.ru/api/zalog.php?type=fedresurs&vin=WBALW31030C540031&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу fedresurs формате JSON

{
  "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"
            }
          }
        ],
        // Лизингополучатели (privatePerson - Физическое лицо, organization - Юридическое лицо, soleProprietorship - Индивидуальный предприниматель)
        "pledgors": [
          {
            // Физическое лицо
            "privatePerson": {
              "name": "Алексей", // ФИО
              "birthday": "1979-11-06" // Дата родения
            },
            "type": "Lessee",
            "publicationDisclaimer": false
          },
          // Юридическое лицо
          {
            "organization": {
              "name": "ООО НАЗВАНИЕ", // Наименование юридического лица
            },
            "type": "Lessee",
            "publicationDisclaimer": false
          },
          // Индивидуальный предприниматель
          {
            "soleProprietorship": {
              "name": "ИВАНОВ ИВАН ИВАНОВИЧ", // ФИО ИП
              "ogrnip": "ОГРНИП" // ОГРНИП
            },
            "type": "Lessee",
            "publicationDisclaimer": false
          }    
        ],
        // Лизингодатели (privatePerson - Физическое лицо, organization - Юридическое лицо, soleProprietorship - Индивидуальный предприниматель)
        "pledgees": [
          {
            "organization": {
              "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ПЕРВЫЙ ЛИЗИНГОВЫЙ ЦЕНТР\""
            },
            "type": "Lessor",
            "publicationDisclaimer": false
          }
        ],
        "guid": "F2E6C6DDFE724E9191B792DDF6D9A000",
        "link": "/api/search/redirect/F2E6C6DDFE724E9191B792DDF6D9A000"
      }
    ]
  },
  "inquiry": {
    "price": 0.6,
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 20,
    "attempts": 1
  }
}

Если в лизинге vin номер не найден

{
	"status":200,
	"num":0,
  "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице)
  "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей)
	"message":"Авто в базе лизинга не найдено",
	// Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Проверка иного движимого имущества

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

https://api-cloud.ru/api/zalog.php?type=otherNotary&id=95789335&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу otherNotary формате JSON

{
  "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": [
        {
          "name": "Юлия Сергеевна ********", // Имя физ лица или организации
		      "nameDetal": "Физическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "birthday": "1*.06.1***" // Дата рождения
		  
        },
        {
          "name": "Юлия Сергеевна ********", // Имя физ лица или организации
		      "nameDetal": "Индивидуальный предприниматель", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "ogrnip": "XXXXXXXXXXXXXX" // ОГРНИП
		  
        },
        {
          "name": "ООО НАЗВАНИЕ", // Имя физ лица или организации
		      "nameDetal": "Юридическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
		  
        } 
      ],
      "pledgees": [
        {
          "name": "Акционерное общество «Всероссийский банк развития регионов»",
          "nameDetal": "Юридическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
        }
      ],
	  // История изменений
	  "history": [
        {
          "id": "2019-003-599590-282",
          "regDate": "2019-04-30T21:02:30",
          "regDateUnix": 1556647350,
          "type": "CREATION",
          "typeTitle": "Возникновение"
        }
      ],
	  // Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
	}
    }
  ]
}

Проверка в реестре залогов по залогодателю

Пример запроса HTTP GET на URL нашего API

https://api-cloud.ru/api/zalog.php?type=notaryPledgor&urINN=0000000000&token=53ba1b7a55abbB014aa97eff3a522079

Пример ответа по типу notaryPledgor когда есть информация формате JSON

{
  "status": 200, // Статус ответа
  "num": 1, // Всего найдено записей
  "page": 1, // Текущая страница поиска (Опционально: 1, Если в tatalPages несколько страниц, то можно передать параметр 'page' с определенной страницей для поиска именно по указанной странице)
  "tatalPages": 1, // Всего страниц с результатами (На одной странице 10 записей)
  // Массив с результатами
  "rez": [
    {
      "regDate": "22.06.2023 12:14:15", // Дата / время записи
      // Массив залогодателей
      "pledgors": [
        {
          "name": "Юлия Сергеевна ********", // Имя физ лица или организации
		      "nameDetal": "Физическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "birthday": "1*.06.1***" // Дата рождения
		  
        },
        {
          "name": "Юлия Сергеевна ********", // Имя физ лица или организации
		      "nameDetal": "Индивидуальный предприниматель", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "ogrnip": "XXXXXXXXXXXXXX" // ОГРНИП
		  
        },
        {
          "name": "ООО НАЗВАНИЕ", // Имя физ лица или организации
		      "nameDetal": "Юридическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
		  
        } 
      ],
      // Массив залогодержатели
      "pledgees": [
        {
          "name": "Коммерческий банк \"Хакасский муниципальный банк\"" // Наименование
          "nameDetal": "Юридическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
        }
      ],
      // Массив с залогами
      "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,
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 14,
    "attempts": 1
  }
}

Пример ответа по типу notaryPledgor когда нет информации формате JSON

{
  "status": 200, // Статус ответа
  "num": 0, // Всего найдено записей
  "page": 0, // Текущая страница поиска
  "tatalPages": 0, // Всего страниц с результатами (На одной странице 10 записей)
  "message": "В базе залогов не найдено", // Детальный ответ
  "inquiry": {
    "price": 1,
    "balance": 466.76,
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "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,
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 8,
    "attempts": 1
  }
}

Проверка в Федресурсе по залогодателю

Пример запроса HTTP GET на URL нашего API

https://api-cloud.ru/api/zalog.php?type=notaryPledgorFedres&urINN=0000000000&token=53ba1b7a55abbB014aa97eff3a522079

Пример ответа по типу notaryPledgorFedres когда есть информация формате JSON

{
  "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": "Физическое лицо", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "birthday": "1*.06.1***" // Дата рождения
		  
        },
        {
          "name": "Юлия Сергеевна ********", // Имя физ лица или организации
		      "nameDetal": "Индивидуальный предприниматель", // Физическое лицо, Юридическое лицо, Индивидуальный предприниматель
          "ogrnip": "XXXXXXXXXXXXXX" // ОГРНИП
		  
        },
        {
          "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,
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 14,
    "attempts": 1
  }
}

Пример ответа по типу notaryPledgorFedres когда нет информации формате JSON

{
  "status": 200, // Статус ответа
  "num": 0, // Всего найдено записей
  "page": 0, // Текущая страница поиска
  "tatalPages": 0, // Всего страниц с результатами (На одной странице 10 записей)
  "message": "В базе Федресурса не найдено", // Детальный ответ
  "inquiry": {
    "price": 1,
    "balance": 466.76,
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "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, // Баланс после текущего запроса
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Пример успешного запроса но с не существующим id по типу notification формате JSON

{
  "status": 200, // Статус ответа
  "url": null, // null результат
  "found": false, // Флаг не найденного файла
  "info": "Указанный ID не найден", // Комментарий
  "inquiry": {
    "price": 1,
    "balance": 683.84,
    "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
    "speed": 4,
    "attempts": 1
  }
}

Ресурс не вернул ответа за отведенный промежуток времени

{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

История изменений API Реестр-залогов

дата	что изменилось
29.10.2024	Метод: notification В выводе добавлен флаг (found) успешности поиска файла. true - файл найден, в url будет ссылка на скачивание файла / false - не найден (например если id был указан неверно), в url будет null Документация обновлена.
23.10.2024	Добавлен новый метод запроса 'notaryPledgorFedres' Позволяет отправить запрос на поиск по залогодателю в Федресурсе. Подробнее в документации.
23.10.2024	Методы notary и fedresurs: 1. Поиск теперь можно осществить не только по vin, но и по номеру шасси и номеру кузова. В запросе минимум 1 доступный вариант. 2. Появился поиск с указанием страницы. Если в результате несколько страниц, т.е. в результате больше 10 записей, то можно указать страницу по которой получаем результат. Метод otherNotary: Появился поиск с указанием страницы. Если в результате несколько страниц, т.е. в результате больше 10 записей, то можно указать страницу по которой получаем результат.
09.10.2024	Тип запроса 'notaryPledgor': 1. Добавлен параметр поиска 'page', позволяющий отправить запрос для получения результатов с указанной страницы. В ответе добавлены флаги 'tatalPages' - сообщает о количестве страниц в результате поиска и 'page' - сообщает на какой странице был произведен поиск. 2. В результате поиска в массиве properties исправлен баг с некоторыми данными которые показывались как null
26.09.2024	notaryPledgor: Исправлено условие возникновения ошибки "ONE OF THE REQUIRED PARAMETERS IS MISSING"
27.04.2024	Добавлен новый метод поиска 'notaryPledgor'. Позволяет осуществить поиск по залогодателям. Осуществить поиск можно по физическим и юридическим лицам. Подробнее в документации.
13.03.2024	Стабилизирована и ускорена обработка всех методов запросов
05.02.2023	Метод запроса: notification 1. Увеличен срок хранения pdf файлов по методу запроса notification до 15 минут. 2. Оптимизрована работа
23.10.2022	В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса.
12.10.2022	1. Провели оптимизацию 2. Восстановили работу типа запроса "notification"
26.09.2022	В документацию добавлена информация по найденным записям лизинга (type->fedresurs)
20.06.2022	В notary и fedresurs добавили кэширование.
03.06.2022	Оптимизированы алгоритмы работы
06.05.2022	Ускорили в разы работу. Работает быстрее и стабильнее.
13.01.2022	Тип запроса: notary В массив pledgors добавлен отличительный параметр залогодателя: Физическое лицо, Юридическое лицо Добавлен в вывод новый массив "properties" - имущество в залоге
06.12.2021	Частая ошибка TIME_MAX_CONNECT. Некорректный регистр VIN параметра При попытке получить данные по VIN в нижнем регистре возникала ошибка таймаута. Решили переводом параметра в верхний регистр.
18.11.2021	Информация о запросе в массиве inquiry Добавлен статус ответа, а так же информация о запросе: Тариф, скорость, количество попыток
21.10.2021	Новые параметр в запросах "allChanges=1" Для type->notary, type->fedresurs, type->otherNotary реализован дополнительный параметр "allChanges". Передавайте его, чтобы осуществить поиск информации о предмете залога во всех уведомлениях о залоге, включая уведомления об изменении/исключении сведений об указанном предмете залога
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, что-то одно.
15	DATE_ERROR Ошибка значения переданной даты
5	TEST_TIME_OFF Закончился период тестирования
3	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
2	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
1	API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

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

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

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

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