Ключ API: что это
Ключ API — строка, по которой сеть понимает, чей запрос пришёл. Ключ работает как пароль для программ: если им завладеет посторонний, он сможет отправлять заявки от вашего имени.
Определение
Вместо логина и пароля программы подтверждают личность ключом. В Лидпульте их два: wmkey — публичный идентификатор вебмастера, виден в кабинете в разделе «Интеграция», и apikey — секретный, он нужен для отправки лидов.
Пример из лидогенерации
Вы выпустили apikey, система показала его один раз. Вы вписали его в настройки трекера. Если ключ потеряли, перевыпуск создаёт новый, а старый сразу перестаёт работать. Запросы со старым ключом получат ответ bad_key (HTTP 401).
Как обращаться с ключом
- Храните в настройках трекера или в переменных окружения сервера, а не в коде страниц и репозиториях.
- Не отправляйте в мессенджерах и не вставляйте на скриншотах.
- Выдавайте разным подрядчикам разные доступы, если это возможно, чтобы понимать источник утечки.
- При малейшем подозрении перевыпустите ключ.
Нюансы
Перевыпуск сразу ломает все интеграции, которые используют старый ключ, поэтому обновите его в трекере сразу после смены. Параллельно проверьте статистику: если появился странный трафик, сообщите менеджеру через страницу контактов.
Практический совет
Заведите привычку проверять, где ещё мог оказаться ключ: в старых скриптах, репозиториях, рабочих чатах, письмах подрядчикам. Если сомневаетесь, перевыпуск занимает минуту, а последствия утечки могут быть куда дороже.
Связанные понятия
Ключ применяется в каждом запросе API. Рядом стоят термины «двухфакторная аутентификация» и «сессия» — они защищают вход в кабинет, а не запросы программ.
Вопросы и ответы
Чем wmkey отличается от apikey?
wmkey — публичный идентификатор аккаунта, apikey — секретная часть. Для отправки лида нужны оба.
Можно ли восстановить потерянный apikey?
Нет, он показывается один раз. Нужно выпустить новый.