Выполнение запросов к API Reestr.net
В данном разделе подробно описан синтаксис, общие параметры и примеры запросов к API Reestr
Синтаксис запроса
Чтобы обратиться к методу API Reestr, Вам необходимо выполнить GET или POST запрос такого вида:
https://reestr.net/api/method/МЕТОД?ПАРАМЕТРЫ&access_token=КЛЮЧ&v=ВЕР&f=ФОРМАТ
Он состоит из нескольких частей:
  • МЕТОД (обязательно) - название метода API, к которому Вы хотите обратиться. Полный список методов доступен на этой странице.
  • ПАРАМЕТРЫ (опционально) - входные параметры соответствующего метода API, последовательность пар name=value, разделенных амперсандом. Список параметров указан на странице с описанием метода.
  • КЛЮЧ (обязательно) - ключ доступа. Подробнее о получении ключа Вы можете узнать здесь.
  • ВЕР (опционально) - используемая версия API. Использование этого параметра применяет некоторые изменения в формате ответа различных методов. ВАЖНО! Старайтесь всегда использовать данный параметр, т.к. по умолчанию ответ сервера будет для последний версии API. Посмотреть все доступные версии API здесь.
  • ФОРМАТ (опционально) - формат возвращаемых данных. Данный параметр принимает всего два значения: json - по умолчанию и xml.

Параметры могут передаваться как методом GET, так и POST. Для передачи данных больше двух килобайт следует использовать POST.

Ограничения и рекомендации
1. Ограничения по частотности запросов в секунду

К методам API Reestr с ключом доступа можно обращаться не чаще 5 раз в секунду.
Если Вы превысите частотное ограничение, сервер вернет ошибку с кодом 6: "Too many requests per second.".

Для увеличения числа запросов в секунду, напишите на нашу почту [email protected], указав цели и задачи, которые Вам необходимо решить.

2. Ограничения по количеству запросов

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

После превышения количественного лимита доступ к конкретному методу может быть временно ограничен. В таком случае сервер не возвращает ответ на вызов конкретного метода, но обрабатывает любые другие запросы.
Пример
Запрос из PHP:
<?php
$request_params = [
'v' => '1.0',
'access_token' => '47a59bc-6d272a0e620f6-c25ceab910e14-610f1-10f1-f6d'
];
$get_params = http_build_query($request_params);
$result = json_decode(file_get_contents('https://reestr.net/api/method/account.info?'. $get_params));
echo $result->response->data->email;
?>
В данном примере скрипт выводит электронный адрес текущего пользователя (email), полученного обращением к методу account.info.
Рекомендации, которые могут Вам помочь найти любой, даже самый сложный объект:
  • если Вы ищете дачный участок, то введите его наименование в окне "улица" не используя кавычек (например, Рыбачий-12);
  • номер участка СНТ вставляйте в окно "квартира" или "корпус";
  • сделайте поиск более обширным: сам населённый пункт не стоит указывать;
  • внесите информацию об улице, номере дома, корпуса и квартиры (если есть);
  • не используйте букву "Ё". Вместо неё попробуйте написать букву "Е";
  • в сложных названиях, особенно когда улица названа в честь кого-то, используйте ключевые слова, например: улица Фридриха Энгельса - напечатайте просто Фридриха.

Вернуться к поиску >