Ключи и проекты
Создание API-ключей, дневной лимит, отключение и отзыв, группировка ключей по проектам и расход по каждому.
Ключ — это пропуск к API. Проект — папка для ключей, чтобы считать расход по клиенту или направлению отдельно. Всё живёт на странице Ключи.
Создание ключа
- Откройте Ключи → «Создать ключ».
- Дайте понятное имя: по нему вы будете узнавать ключ в журнале и в статистике. Хорошо — «прод-бот», «сайт-виджет»; плохо — «ключ 2».
- При желании задайте дневной лимит и проект.
- Скопируйте значение — оно показывается один раз. В базе остаётся только хеш, восстановить нельзя.
Потеряли ключ — создайте новый и отзовите старый; это нормальная практика, а не авария.
Дневной лимит
Лимит ограничивает траты по ключу за скользящие 24 часа. Превышение — ошибка 429 daily_limit_exceeded, остальные ключи продолжают работать.
Лимит полезен, когда ключ уезжает в чужие руки: подрядчику, в тестовый стенд, в публичное демо. Без лимита один цикл в чужом коде способен съесть весь баланс.
Задать или изменить — на странице ключа, поле «Дневной лимит». Пусто = без лимита.
Отключение и отзыв
На странице ключа есть два разных действия:
| Действие | Что происходит | Обратимо |
|---|---|---|
| Отключить | Ключ отвечает 401, статистика и значение сохраняются | Да, включается обратно |
| Отозвать | Ключ перестаёт работать навсегда | Нет |
Отключение удобно, когда нужно быстро остановить подозрительный трафик и разобраться. Отзыв — когда ключ точно скомпрометирован или больше не нужен.
История запросов в обоих случаях остаётся в журнале: отзыв ключа не стирает прошлые траты.
Проекты
Проект группирует ключи внутри вашего кабинета. Это удобно, если вы ведёте нескольких клиентов или несколько направлений и хотите видеть, сколько потратил каждый.
Своего баланса у проекта нет: деньги общие, проект делит учёт, а не кошелёк.
Как завести
- На странице Ключи нажмите «+ Проект».
- Задайте название и цвет метки.
- Разложите ключи: на странице ключа поле «Проект», либо выберите проект сразу при создании.
Над списком ключей появится полоса вкладок: «Все ключи», затем ваши проекты и «Без проекта». Выбранная вкладка фильтрует список, а в подзаголовке показывает сводку — сколько ключей и сколько потрачено за 30 дней.
Расход по проекту
- На странице Использование — карточка «Распределение расхода по проектам».
- В журнале запросов — фильтр «Проект» рядом с фильтром «API-ключ».
Ключ можно переложить в другой проект в любой момент — история его расходов переезжает вместе с ним. Это сделано специально: первая раскладка ключей по клиентам почти всегда получается неточной, и её нужно уметь исправить задним числом.
Удаление проекта
Удаляется только группировка: ключи возвращаются в «Без проекта» и продолжают работать. Ни одна интеграция от удаления проекта не сломается.
Что дальше
- Аутентификация — как передавать ключ в запросах
- Кабинеты клиентов — если ключи заводит подрядчик
- Лимиты частоты — ограничения на стороне API
Обновлено: