Авторизация
Ключей два, и они не взаимозаменяемы.
- Ключ API - секретный, передаётся заголовком
X-Api-Key. Им авторизуются обращения из вашего кода. Выдаётся в кабинете, раздел «Настройки бота» → вкладка «Для разработчиков». Ключ не привязан к домену и работает откуда угодно - поэтому его нельзя класть в код страницы, которую видит покупатель. - Ключ виджета (
key, он же slug проекта) - публичный, для чата на вашем сайте. Работает только из браузера: запрос безOriginилиRefererотклоняется. Он есть у каждого проекта, но программно им ходить нельзя - для этого и нужен ключ API.
Что защищает от чужого использования
- Список разрешённых доменов - для ключа виджета: запрос принимается, только если
OriginилиRefererвходит в список. Настраивается в кабинете; пустой список означает «отовсюду». К ключу API неприменим - там нет ни страницы, ни домена. - Лимит частоты - 20 запросов в минуту с одного адреса и 120 в минуту на проект.
- Баланс - стоимость каждого ответа списывается с баланса проекта; когда денег не хватает на ответ, приходит ошибка.