Практическая инструкция · сверено 16.10.2026

Как создать, проверить и отозвать ключ API AppsMax

Владелец организации выдаёт отдельный ключ, сохраняет его при создании и проверяет двумя способами: в кабинете и запросом к API. Когда доступ не нужен, отзывает конкретную запись.

Пройти по шагам ↓Уже есть аккаунт? Открыть ключи →

Ключ действует для всей организации. Отзыв сразу остановит интеграцию, которая его использует.

ТРИ ОТМЕТКИ ВЛАДЕЛЬЦА

01Выдатьправа для задачи
02Проверитьстатус и запрос
03Отозватьточный ключ

ЗНАЧЕНИЕ
НЕ ПИШЕМ
НА БУМАГЕ

Бумажная схема порядка, без интерфейса и без данных организации.

Ключ API разрешает внешней программе обращаться к данным AppsMax от имени всей организации. Владелец создаёт отдельный ключ для одной задачи, сохраняет полное значение при выдаче, проверяет его и отзывает, когда доступ больше не нужен. Выбранный в шапке проект не ограничивает область ключа.

Если задачу решает встроенное подключение Google Sheets, начните с раздела интеграций. Для CRM проверьте доступный рецепт и требования вашей системы: наличие рецепта не обещает готовую связь с любой CRM. Собственный REST API — технический маршрут для системы, которую настраивает ваш исполнитель.

01 / Подготовка

Сначала назовите задачу и владельца

Решите, какие именно данные система будет читать или изменять. Например, для получения заявок ей не нужны права на рассылки. Укажите ответственному исполнителю название интеграции и нужные действия, но не передавайте ему доступ к кабинету владельца без необходимости.

Ключами организации управляет её владелец. REST API доступен по текущей сетке начиная с тарифа «Автоматизация» за 1 000 ₽ в месяц; сверьте тариф перед оплатой. Для тестовой и рабочей среды используйте разные ключи.

02 / Выдача

Создайте ключ с нужными правами

Войдите в кабинет AppsMax как владелец организации и откройте «Данные → API и интеграции → Ключи API».
Нажмите «Создать ключ» и дайте ему понятное название, например «n8n — заявки».
Откройте «Настроить права вручную» и оставьте только операции, нужные этой системе. Набор «Рекомендуемые» включает права чтения разных объектов и изменение заявок; это не минимальный набор для любой задачи.
Проверьте выбранные права и нажмите «Создать ключ». Платформа требует хотя бы одно право.

Важная граница: разрешение действует для всей организации, а не только для проекта, открытого в шапке. Право applications:write нужно для изменения заявок, но не для одного просмотра.

В ручном списке прав API отмечено только «Организация: просмотр» — В ручном списке отмечено только «Организация: просмотр» для проверочного GET /me. Для рабочей интеграции набор прав выбирают под её действия. Снимок действующего кабинета от 16 октября 2026 года.

03 / Сохранение

Полное значение видно только сейчас

После создания кабинет показывает полный ключ и кнопку «Скопировать». Сохраните значение в защищённом хранилище системы, которая будет выполнять запросы. Не вставляйте его в ссылку, код страницы, чат, снимок экрана или общую таблицу. Затем нажмите «Я сохранил ключ».

Позже в списке будут видны название, короткое начало, права и состояние. Полный ключ восстановить из списка нельзя. Если он потерян, подготовьте новый и отзовите старый.

04 / Две проверки

Активен — ещё не значит подключён

В кабинете

Раскройте «Проверить сохранённый ключ», вставьте значение и нажмите «Проверить ключ». Эта проверка сверяет хеш, состояние и организацию. Она не отправляет запрос во внешнюю систему и не доказывает работу API-клиента.

Из вашей системы

Исполнитель выполняет GET /me по актуальному базовому адресу из раздела API, передавая ключ в заголовке Authorization: Bearer. Запрос не меняет бизнес-данные, но при успешной авторизации может обновиться служебная отметка использования ключа last_used_at. Сверьте в ответе организацию и права, затем одну нужную операцию чтения. Полный порядок — в инструкции первого запроса.

Запросы записи и работа с реальными заявками — отдельная проверка в согласованном тестовом контуре. Не проверяйте чужую интеграцию на клиентских данных.

05 / Смена

Проверьте замену до отзыва

Создайте новый ключ с теми же необходимыми или меньшими правами и сохраните его один раз.
Поменяйте значение в своей системе и проверьте новый ключ в кабинете.
Попросите исполнителя выполнить GET /me и нужный безопасный запрос уже новым ключом.
Когда система перешла на новое значение, отзовите прежний ключ и убедитесь, что запрос с ним получает 401.

Возможность создать два ключа не гарантирует смену без перерыва: это зависит от развёртывания внешней системы. При подозрении на утечку затронутый ключ отзывают сразу, не дожидаясь планового перехода.

06 / Отзыв

Отзывайте только нужную запись

В списке «Ключи API» найдите ключ по названию и короткому началу, нажмите «Отозвать» и подтвердите предупреждение. Интеграции, использующие именно этот ключ, сразу потеряют доступ. Статус записи станет «Отозван»; повторное использование ключа публичным API получает 401. Действие не меняет токены ботов Telegram или MAX и отдельные секреты webhook.

Если ключ утрачен, значение нельзя посмотреть снова: создайте замену с нужными правами и отзовите старую запись. Не удаляйте соседний ключ другой системы только из-за похожего названия.

07 / Если не работает

Сверьте состояние до повторной выдачи

401: Проверьте, не отозван ли ключ и передаётся ли он в нужном заголовке. Отсутствующий или неверный ключ также даёт отказ авторизации.
403: Проверьте права ключа, тарифный доступ и разрешение на конкретную операцию. Один успешный GET /me не даёт всех прав записи.
Ключ не найден: Полное значение не восстанавливается из списка. Уточните организацию, затем создайте новый ключ и отзовите потерянный.

Дополнительные правила хранения и реагирования — в памятке по безопасности интеграций. Точный контракт запросов и прав — в справочнике для разработчика; клиенту не нужно читать его для готовой интеграции.

Описание сверено по исходникам установленной платформы 16 октября 2026 года. Это не проверка подключения из вашей системы. Перед рабочим запуском проверьте текущий тариф, интерфейс и доступную версию API.