Пошаговое руководство: как получить API-ключ для разработчиков и квалифицированную электронную подпись
Чтобы интегрировать Госуслуги или Честный ЗНАК, нужно знать, как получить API-ключ для разработчиков и квалифицированную электронную подпись. КЭП подписывает запросы, а ключ авторизует приложение.
Оглавление
Получение квалифицированной электронной подписи (КЭП)
Для физических лиц, ИП и руководителей организаций: подпись выдается бесплатно через мобильное приложение «Госключ» (разработка Минцифры России). Путь в меню: открыть приложение → на главном экране в правом верхнем углу перейти в «Настройки» → «Получить сертификат УКЭП ФЛ». Требуется подтвержденная учетная запись на Госуслугах или идентификация через банк. Приложение официально доступно в Google Play, AppGallery и AppStore, но для пользователей из РФ основным и самым стабильным каналом загрузки является RuStore.
Для сотрудников организаций: с 1 сентября 2024 года (и актуально в 2026 году) работники должны использовать КЭП физического лица, выдаваемую аккредитованным Удостоверяющим центром (УЦ), исключительно совместно с машиночитаемой доверенностью (МЧД), подписанной КЭП руководителя.
Использование КЭП физического лица для действий от имени организации без правильно оформленной и зарегистрированной МЧД делает подписанные документы и API-запросы юридически недействительными, что влечет штрафы и отказ в обслуживании.
С 1 февраля 2026 года вступили в силу новые правила оформления МЧД (Приказ Минцифры), упрощающие формат (например, исключение паспортных данных из некоторых полей), что важно учитывать при генерации доверенности для сотрудника.
Если электронная подпись нужна только для входа в систему (без юридически значимого подписания документов), подойдет УНЭП (усиленная неквалифицированная электронная подпись), которая оформляется за 15 минут прямо в приложении или на сайте Госуслуг, но для строгого API-взаимодействия с госорганами требуется именно УКЭП (КЭП).
Получение API-ключа разработчика
API-ключ генерируется в личном кабинете разработчика конкретного сервиса (например, «Честный ЗНАК», API Госуслуг, Яндекс, Сбер).
Типичный путь: Регистрация в системе → Раздел «Для разработчиков» / «Настройки API» / «Доступ» → Создать API-ключ → Скопировать и сохранить.
Секретный API-ключ отображается в интерфейсе только один раз при создании; его утеря потребует перевыпуска, что может временно остановить работу интеграции.
Оплата услуг коммерческих УЦ или платных API-шлюзов возможна только российскими банковскими картами (МИР) или по безналичному расчету для юридических лиц.
При создании API-ключа в некоторых государственных системах (например, API Госуслуг для вендоров) обычно требуется предварительно загрузить открытый ключ сертификата КЭП в профиль разработчика для жесткой привязки ключа к владельцу.
Связь КЭП и API на практике
Для многих государственных и регулируемых API (например, «Честный ЗНАК», Госуслуги) запросы к API должны быть криптографически подписаны с помощью КЭП (через КриптоПро CSP или встроенные средства, например, PyCades или API «Госключа»).
Для работы с API «Честного ЗНАКа» или Госуслуг на компьютере требуется установка криптопровайдера (например, КриптоПро CSP) и наличие действующего контейнера с закрытым ключом КЭП на устройстве, с которого отправляются запросы.
Передача закрытого ключа КЭП или API-ключа третьим лицам дает возможность злоумышленникам подписывать документы или делать запросы от вашего имени.
Частые ошибки
- Использование КЭП физлица без МЧД. Попытка действовать от имени организации с личной подписью сотрудника без зарегистрированной машиночитаемой доверенности.
- Потеря API-ключа. Несохранение секретного ключа сразу после его генерации, что приводит к необходимости перевыпуска и простою интеграции.
- Отсутствие криптопровайдера. Попытка отправить подписанный запрос к API без установленного КриптоПро CSP и активного контейнера с закрытым ключом на устройстве.
FAQ
Где скачать приложение «Госключ» для получения бесплатной КЭП?
Приложение официально доступно в RuStore, Google Play, AppGallery и AppStore. Для пользователей из РФ основным и самым стабильным каналом загрузки является RuStore.
Можно ли использовать УНЭП вместо КЭП для работы с API?
УНЭП подходит только для входа в систему без юридически значимого подписания. Для строгого API-взаимодействия с госорганами требуется именно УКЭП (КЭП).
Как оплачивать услуги коммерческих УЦ или платных API-шлюзов?
Оплата возможна только российскими банковскими картами («МИР») или по безналичному расчету для юридических лиц.