Аутентификация Partner API: Bearer-ключи ec_live_, ротация и ошибки 401
Каждый запрос Partner API несёт секретный ключ аккаунта в заголовке Authorization: Bearer ec_live_…, отправляемом с вашего сервера. У каждого аккаунта easyCoexistence есть один ключ. Его можно создать в панели в разделе Profile, Developers или попросив ИИ-ассистента выполнить create_api_key. Ключ показывается только один раз. Ротация выпускает новый ключ и сразу отключает старый; отсутствующий или неверный ключ возвращает 401 unauthorized.
Префикс, с которого начинается каждый ключ Partner API; передаётся в каждом запросе как Authorization: Bearer.
Количество ключей, которое аккаунт держит одновременно; каждое подключение, созданное с ним, принадлежит этому аккаунту.
Статус при отсутствующем или неверном ключе, с кодом ошибки unauthorized и сообщением, называющим ожидаемый заголовок.
Сколько раз показывается полный ключ: при создании или ротации. Потом видны только первые символы.
Как запрос проходит аутентификацию?
Ключ передаётся как Bearer-токен в заголовке Authorization каждого запроса к https://easycoexistence.com/api/v1. Больше ничего не подписывается и не ограничивается по областям доступа: ключ определяет аккаунт, а всё, что запрос создаёт или читает, принадлежит этому аккаунту. Тела запросов в формате JSON, каждая ошибка возвращается объектом с полями code и message.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Где создать ключ?
В панели или через ИИ-ассистента, результат один и тот же. В панели откройте Profile, затем Developers и нажмите Create API key. В Claude, ChatGPT или другом ассистенте, подключённом к MCP-серверу easyCoexistence, попросите настроить Partner API: get_partner_setup покажет, чего не хватает, а create_api_key вернёт ключ. В обоих случаях полный ключ появляется один раз, поэтому сразу сохраните его в секретах вашего бэкенда.
Почему ключ показывается только один раз?
Потому что хранится только его хеш. easyCoexistence хранит хеш для проверки каждого запроса, а также первые символы ключа, ec_live_ и ещё шесть, чтобы панель могла показать, какой ключ действует и когда он создан. Потерянный ключ нельзя показать повторно; ротация его заменяет.
Как ротировать или отозвать ключ?
В один шаг. Старый ключ перестаёт работать в тот же момент, без льготного периода, так как чаще всего ключ ротируют из-за утечки. Новый ключ показывается один раз, как и первый:
- Панель: Profile, Developers, Rotate key.
- MCP:
create_api_keyсreplace_existing, равным true. Без него инструмент откажет, пока ключ существует, поэтому работающая интеграция не сломается случайно. - Чтобы закрыть весь доступ, отзовите ключ: Revoke в панели или
revoke_api_keyс confirm, равным true. Запросы тогда будут падать, пока не будет создан новый ключ.
Что возвращает отсутствующий или неверный ключ?
401 с кодом unauthorized: для запроса без заголовка Authorization, ключа, который не начинается с ec_live_, или ключа, который был заменён или отозван. Сообщение называет ожидаемый заголовок. Если неудачные запросы идут с одного адреса, API отвечает 429 rate_limited и указывает, сколько секунд ждать перед повтором.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Почему может быть отказано и при верном ключе?
Верный ключ подтверждает аккаунт, но состояние аккаунта всё равно учитывается. Ответы приходят в той же структуре ошибки:
- 402
billing_required: на аккаунте ещё нет карты, поэтому сессии подключения не запускаются. - 404
not_found: идентификатор не принадлежит ни одному подключению, каналу или сессии этого аккаунта, включая подключения других аккаунтов. - 409 removed: подключение удалено, поэтому его вебхук нельзя изменить.
- 402 suspended: подключение приостановлено из-за просроченной подписки; сначала подключите его снова.
- 429
cap_reachedилиrate_limited: слишком много открытых сессий подключения или слишком много созданных за час.
Распространённые ошибки
- Ключ во фронтенд-коде. Любой, кто откроет страницу, сможет прочитать его, создать подключения, которые оплачиваете вы, и получить токены клиентов через ?credentials=1.
- Ротация до того, как бэкенд примет новый ключ. Старый ключ перестаёт работать сразу, поэтому каждый запрос получает 401, пока новый не будет развёрнут.
- Создание ключа в разговоре, которым вы делитесь. create_api_key возвращает его в чат, где он остаётся в истории, поэтому, если разговор открыт другим, ротируйте ключ.
- Сохранение ключа в кавычках. Всё после Bearer читается как ключ, поэтому значение в кавычках никогда не совпадает, и каждый запрос получает 401.
easyCoexistence выдаёт каждому аккаунту один ключ Partner API, чтобы ваш бэкенд мог подключать WhatsApp-номера ваших клиентов, их аккаунты Instagram, Facebook, TikTok, YouTube и LinkedIn и другие каналы, а затем читать учётные данные каждого подключения и направлять его события. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Может ли у аккаунта быть больше одного ключа Partner API?
Нет. У аккаунта одновременно один ключ, а новый ключ заменяет старый. Разные ключи означают разные аккаунты easyCoexistence, у каждого со своими подключениями и своим счётом.
Истекают ли ключи Partner API?
Нет. Ключ работает, пока его не ротируют или не отзовут, либо пока easyCoexistence не закроет его за нарушение правил Meta.
Нужен ли моим клиентам мой ключ для подключения?
Нет. Они открывают только размещённую ссылку подключения, у которой есть собственный идентификатор сессии. Ключ остаётся на вашем сервере и используется только вашим бэкендом.
Совпадает ли ключ API с секретом подписи событий?
Нет. Ключ аутентифицирует ваши запросы к API. Секрет подписи, который показывается один раз при настройке URL для событий статуса, позволяет вашему эндпоинту проверять события, которые отправляет easyCoexistence.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на