API-ключ — секретная строка, по которой сервис узнаёт программу-клиента, даёт ей доступ к API и считает её расход.
API-ключ (API key, ключ API) — это строка символов, которую сервис выдаёт в личном кабинете для доступа к API. Программа передаёт её в каждом запросе, обычно в заголовке, и по ключу сервис понимает, чей это запрос, какие действия разрешены и с чьего баланса списывать деньги.
API-ключ простыми словами
Ключ равен паролю. Тот, у кого он есть, действует от имени владельца. Сервис по нему распознаёт клиента и открывает доступ к функциям.
Как работает API-ключ
Сервис выдаёт ключ в личном кабинете. Программа вставляет строку в каждый HTTP-запрос, обычно в заголовок. Сервис проверяет ключ, сверяет права и выполняет операцию. Многие сервисы позволяют ограничить ключ: только чтение, лимит расхода, список разрешённых адресов.
API-ключи в арбитраже трафика
В арбитраже ключи нужны для трекеров, рекламных сетей, партнёрских программ (выгрузка статистики), нейросетей и сервисов SMS-активаций. Утёкший ключ нейросети или рекламного кабинета означает чужие расходы на балансе владельца.
Как хранить ключ и что делать при утечке
Ключ хранят в переменных окружения или менеджере секретов. Его не вставляют в код и публичные репозитории, не пересылают в чатах, не оставляют в шаблонах автоматизации, которыми делятся с другими. При утечке ключ отзывают в кабинете и выпускают новый.