Документация по работе с API Министерство Экономического Развития РФ
Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа
HTTPS GET запрос: https://api-cloud.ru/api/economyrf.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| guide | Поиск в реестре экскурсоводов и гидов-переводчиков |
Обязательные string - Строка поиска (Наименование, Реестровый номер, ИНН, ОГРН) Разрешено: [а-яА-Я0-9-/\s] page - Страница поиска Разрешено: [0-9] token - персональный ключ API |
| tour | Поиск реестру туроператоров и турагентов |
Обязательные string - Строка поиска (Наименование, Реестровый номер, ИНН, ОГРН) Разрешено: [а-яА-Я0-9-/\s] page - Страница поиска Разрешено: [0-9] 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/economyrf.php?' . http_build_query($data);
$data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.
Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.
Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
Примеры запросов
Поиск в реестре инструкторов-проводников
https://api-cloud.ru/api/economyrf.php?type=guide&string=%D0%A2027-01367-78/05664464&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"totalElements": 1, // Все строк
"totalPages": 1, // Всего страниц
"page": 1, // Текущая страница
// Массив с результатами
"data": [
{
"id": "6a61b3a20887ead196fc7648", // id записи
"status": "active", // Статус записи
"reestr_number": "Т027-01367-78/05664464", // Реестровый номер
"dateIssued": "2026-07-23T00:00:00.000+0000", // Дата записи
"subject": {
// ФИО
"person": {
"lastName": "АНТОНОВА", // Фамилия
"firstName": "НАТАЛЬЯ", // Имя
"middleName": "АЛЕКСЕЕВНА" // jnxtcndj
},
// Сведения об аттестации
"certification": [
{
"date": "2026-07-23T00:00:00.000+0300", // Дата принятия решения об аттестации
"period": "2031-07-23T00:00:00.000+0000", // Дата проведения планового подтверждения соответствия
// Массив с языками
"gidiyazik": [
{
"code": "10", // код
"name": "Итальянский" // расшифровка
}
],
// Организация аттестации
"responsibleOrganization": {
"id": "630476db9b394000019ccba6", // id
"name": "Комитет по развитию туризма Санкт-Петербурга", // Организация
"ogrn": "1127847685778", // ОГРН
// Регион
"region": {
"code": "78",
"name": "г. Санкт-Петербург"
}
}
}
],
// ФИО на английском
"infoEnglish": {
"name": "Natalia", // Имя
"surname": "Antonova", // Фамилия
"patronymic": "Alekseevna" // Отчество
},
"imgPhoto": "https://tor.knd.gov.ru/helper/storage/download?fileId=6a61df72e7dbebde190406dc", // Фото
// зона аттестации
"attestationArea": {
"code": "translator", // Код
"name": "Гид-переводчик" // Расшифровка
}
}
}
],
"inquiry": {
"price": 0.3,
"balance": 8465.73,
"credit": 20000,
"speed": 0,
"attempts": 1
}
}
Поиск реестру туроператоров и турагентов
https://api-cloud.ru/api/economyrf.php?type=tour&string=РТА 0054223&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"totalElements": 1, // Всего записей
"totalPages": 1, // Всего страниц
"page": 1, // Текущая страница
// Массив с результатами
"data": [
{
"id": "cf5f1d38-9e84-4af4-a61e-9bcac868e401", // ID записи
"efrtaId": "РТА 0054223", // Реестровый номер турагента
"efrtId": null, // Реестровый номер туроператора
"fullName": "ИВАНОВА НАТАЛЬЯ ЮРЬЕВНА", // Полные ФИО или Полное юридическое наименование
"name": "ИВАНОВА НАТАЛЬЯ ЮРЬЕВНА", // ФИО или юридическое наименование
"ogrn": "324390000012390", // ОГРН
"inn": "390801017379", // ИНН
"kpp": null, // КПП
"address": "236011, КАЛИНИНГРАДСКАЯ ОБЛАСТЬ, Г. КАЛИНИНГРАД", // Адрес
"date": "2026-07-16", // Дата записи
"type": "TOURAGENT" // Тип записи (TOURAGENT - турагент / TOUROPERATOR - туроператор)
}
],
"inquiry": {
"price": 0.3,
"balance": 8571.53,
"credit": 20000,
"speed": 0,
"attempts": 1
}
}
История изменений API Министерство Экономического развития
| дата | что изменилось |
|---|
Возможные коды ошибок
| код (error) | Описание ошибки (message) |
|---|---|
| 888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
| 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 |
| 5 | TEST_TIME_OFF Закончился период тестирования |
| 499 | WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа. |
| 498 | TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс. |
| 460 | NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры |
| 456 | MAX_LIMIT Превышено количество одновременных соединений (потоки) |
| 404 | TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже. |
| 3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
| 2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
| 15 | DATE_ERROR Ошибка значения переданной даты |
| 123 | IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК |
| 111 | PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно. |
| 1 | API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}