Выполнение запросов к API

Выполнение запросов к 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.".

Для увеличения числа запросов в секунду, напишите на нашу почту info@reestr.net, указав цели и задачи, которые Вам необходимо решить.

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.

Онлайн сервисы Реестра:

Полезное:

Справочная:

Помощь: