Лидпульт

Ключ API: что это

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

Определение

Вместо логина и пароля программы подтверждают личность ключом. В Лидпульте их два: wmkey — публичный идентификатор вебмастера, виден в кабинете в разделе «Интеграция», и apikey — секретный, он нужен для отправки лидов.

Пример из лидогенерации

Вы выпустили apikey, система показала его один раз. Вы вписали его в настройки трекера. Если ключ потеряли, перевыпуск создаёт новый, а старый сразу перестаёт работать. Запросы со старым ключом получат ответ bad_key (HTTP 401).

Как обращаться с ключом

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

Нюансы

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

Практический совет

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

Связанные понятия

Ключ применяется в каждом запросе API. Рядом стоят термины «двухфакторная аутентификация» и «сессия» — они защищают вход в кабинет, а не запросы программ.

Вопросы и ответы

Чем wmkey отличается от apikey?

wmkey — публичный идентификатор аккаунта, apikey — секретная часть. Для отправки лида нужны оба.

Можно ли восстановить потерянный apikey?

Нет, он показывается один раз. Нужно выпустить новый.