Создание и отзыв ключей API

Опубликовано · Обновлено

Подключайте свои данные, CRM и ИИ-ассистентов с правами вашей учётной записи.

  1. Назовите интеграцию в Ключах API; максимум 10 активных ключей. Полный секрет показывается один раз, затем видны только скрытые данные.

  2. Отправляйте Authorization: Bearer YOUR_API_KEY с защищённого сервера на https://api.activationking.com. Начните с GET /v1/me для аккаунта и ID организаций. Не публикуйте ключ в браузере, URL, снимках или сообщениях поддержке.

  3. Документированные GET возвращают подписки, кредиты, события, сессии, файлы, статистику и ответы лидов/опросов. Списки содержат items, nextCursor и totalCount. Передавайте nextCursor как cursor до null; limit не больше 100. Время UTC, поля JSON camelCase.

  4. Ops Calendar читает/записывает компании, задания и сделки по роли владельца ключа и активному доступу организации. Передайте X-Organization-Id из /v1/me и сначала прочитайте справочники. PUT /v1/ops/companies/external/{source}/{externalId} и аналог jobs обновляют ту же запись при повторном импорте. Подтверждайте запись и удаление: они меняют реальные данные.

  5. Перед PATCH настроек прочитайте GET /v1/settings/catalog и GET /v1/events/{eventId}/settings. Только документированные ключи/типы; null возвращает исходное значение, неверный ввод отменяет всё сохранение. Киоск применяет при следующей синхронизации. В Ops PATCH пропущенные/null поля не меняются, а переданный список заменяет весь список: разные правила null.

  6. 300 запросов в минуту на ключ. Проверяйте X-RateLimit-Limit и X-RateLimit-Remaining; при 429 ждите секунды Retry-After. Проверяйте код: 401 аутентификация, 403 доступ, 404 нет/недоступно, Ops 402 нет активного доступа организации. Не повторяйте постоянно отозванный ключ.

  7. ИИ-ассистенты подключаются к https://api.activationking.com/mcp через Streamable HTTP с тем же ключом Bearer, лимитами и ролями. Инструменты записи MCP меняют реальные данные и требуют явного подтверждения. Краткая/полная Markdown-справка и схема OpenAPI ниже описывают актуальные поля, инструменты и методы.

  8. Утерянный или раскрытый ключ отзовите и замените. Режим доступа поддержки к аккаунту не позволяет создавать или отзывать ключи.

Доступность определяется текущими правами, включёнными функциями и подтверждёнными операциями.

Эта статья была полезной?

Не знаете, с чего начать? Мы поможем.

Расскажите о своем проекте. Наша команда поможет с дальнейшими шагами.

Отправляя форму, вы соглашаетесь с нашими Условиями и Политикой конфиденциальности.