Документация по работе с API Реестр иностранных агентов
Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/inoagent.php с персональным ключом API и параметрами.
Пример отправки 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/inoagent.php?' . http_build_query($data);
$data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.
Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа
Реестр обновляется согласно обновленным данным на сайте Минюста
Последнее обновление: 15.11.2024
Последнее обновление: 15.11.2024
| type (Метод) | Описание | Параметры в запросе |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| search | Произвести поиск по строке поиска в реестре иностранных агентов
• Полное наименование (прежнее наименование(в случае его изменения)/ФИО (псевдоним (при наличии), прежнее ФИО (в случае их изменения)
• Дата рождения
• ИНН
• СНИЛС
• ОГРН
• Регистрационный номер
• Адрес (место нахождения)
• Доменное имя информационного ресурса (при наличии)
• Полное наименование/ФИО участников
• Основания включения
• Дата принятия решения о включении
• Дата опубликования принятого Минюстом России решения о включении в реестр
• Дата принятия решения об исключении
|
Обязательные string - Регистрационный номер транспортного средства Разрешено для string: кириллица, латиница, цифры, знаки "- : .", минимум 4 символов |
Примеры запросов
Пример запроса "search" HTTP GET на URL нашего API
https://api-cloud.ru/api/inoagent.php?type=search&string=оксимирон&token=53ba1b7a55abbB014aa97eff3a522079
Найдены результаты в реестре иноагентов
{
"status": 200, // Статус ответа
"date_update": "21.06.2024", // Дата обновления реестра
// Массив с результатами
"result": [
{
"name": "Федоров Мирон Янович (псевдоним - Oxxxymiron (Оксимирон))", // Полное наименование иноагента
"birth": "31.01.1985", // Дата рождения
"ogrn": "", // ОГРН
"regnum": "", // Регистрационный номер
"inn": "78025575xxxx", // ИНН
"snils": "175-830-xxx 04", // СНИЛС
// Массив доменных имен
"domen": [
"https://vk.com/xxxxxxx"
],
// Массив с участниками
"fioUchastnikov": [],
// Основание включения в реестр
"osnovanie": "Статья 2.1 Федерального закона от 28.12.2012 № 272-ФЗ \"О мерах воздействия на лиц, причастных к нарушениям основополагающих прав и свобод человека",
"date_inclusion": "07.10.2022", // Дата принятия решения о включении
"date_publish": "", // Дата опубликования принятого Минюстом России решения о включении в реестр
"date_exception": "" // Дата принятия решения об исключении
}
],
"inquiry": {
"price": 0.3,
"balance": 682.25,
"speed": 0,
"attempts": 1
}
}
В реестре иностранных агентов результатов не найдено
{
"status": 200,
"date_update": "21.06.2024",
"result": [],
"inquiry": {
"price": 0.3,
"balance": 681.65,
"speed": 0,
"attempts": 1
}
}
История изменений API Реестр иностранных агентов
| дата | что изменилось |
|---|---|
| 15.11.2024 | Обновлен реестр, добавлено 2 иноагента, 1 иноагент исключен |
| 08.11.2024 | Обновлен реестр, добавлено 4 иноагента |
| 01.11.2024 | Обновлен реестр, добавлено 4 иноагента, 1 иноагент исключен |
| 25.10.2024 | Обновлен реестр, добавлено 5 иноагентов |
| 18.10.2024 | Обновлен реестр, добавлено 6 иноагентов, 3 иноагента исключено |
| 27.09.2024 | Обновлен реестр, добавлено 6 иноагентов |
| 20.09.2024 | Обновлен реестр, 1 иноагент исключен |
| 13.09.2024 | Обновлен реестр, добавлено 6 иноагентов |
| 06.09.2024 | Обновлен реестр, добавлено 4 иноагента, 1 иноагент исключен |
| 30.08.2024 | Обновлен реестр, добавлено 4 иноагента |
| 23.08.2024 | Обновлен реестр, исключено 3 иноагента |
| 16.08.2024 | Обновлен реестр, добавлено 6 иноагентов |
| 26.07.2024 | Обновлен реестр, добавлено 2 иноагента |
| 19.07.2024 | Обновлен реестр, добавлено 4 иноагента, 1 иноагент исключен |
| 12.07.2024 | Обновлен реестр, добавлено 3 иноагента |
| 06.07.2024 | Обновлен реестр, добавлено 5 иноагентов |
| 29.06.2024 | Обновлен реестр, добавлено 6 иноагентов |
Возможные коды ошибок
| код (error) | Описание ошибки (message) |
|---|---|
| 888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
| 802 | MINIMUM_NUMBER_OF_CHARACTERS_ERROR В строке поиска не достигнуто минимальное количество символов |
| 801 | FORBIDDEN_SYMBOLS В параметре поиска присутствуют запрещенные символы или отсутствует строка поиска |
| 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"}