Создать и отозвать ключ API

Результат: у одной внешней системы будет отдельный проверенный ключ с минимальными правами.

До начала

Подготовьте понятное имя, например «n8n — заявки», и определите действия интеграции. Не используйте один ключ для CRM, отчётов и тестов одновременно.

Создание

1. Откройте «Настройки → Интеграции → Ключи API».
2. Нажмите создание ключа.
3. Введите назначение ключа.
4. Выберите готовый набор прав или отметьте права вручную.
5. Для первого GET /me отдельный scope не нужен. Для данных выдайте только нужные :read; права :write добавляйте лишь для записи.
6. Создайте ключ.

Проверка

Сохраните ключ на сервере интеграции и выполните безопасный запрос:

curl --fail-with-body \
  -H "Authorization: Bearer $APPSMAX_API_TOKEN" \
  https://telegram.appsmax.ru/api/v1/me

Ротация без простоя

1. Создайте новый ключ с теми же или меньшими правами.
2. Замените секрет в интеграции.
3. Убедитесь, что запрос с новым ключом возвращает 200.
4. Отзовите старый ключ.
5. Проверьте, что старый теперь получает 401.

Частые ошибки

• 401 — ключ отсутствует, отозван или передан не как Bearer.
• 403 — ключ действителен, но не имеет нужного права API или доступа к организации.
• Ключ потерян — старое значение не восстанавливается; создайте новое и отзовите старое.

Дальше: первый запрос и импорт OpenAPI/Postman.