Открытый API · только чтение

Программно запрашивайте расход и срок действия ключей

Создайте токен только для чтения в панели и одной командой получайте срок, суточный расход и квоту каждого активного ключа — затем подключите к своим скриптам, дашбордам и оповещениям.

Только чтение, не трогает баланс Создание / сброс в один клик Ответ в JSON, лёгкая интеграция

Что можно запросить

Один токен — ключевые операционные метрики ваших ключей

Срок действия

Точный срок действия каждого активного ключа — планируйте продление заранее и избегайте простоев.

Расход за день и месяц

Сегодняшние расходы и число запросов, использованная квота за месяц, лимит и загрузка — всё сразу.

Самостоятельное управление токеном

Создавайте, сбрасывайте или отзывайте токен в панели; сервер хранит только хеш, открытый текст показывается один раз.

Интеграция в три шага

От создания токена до рабочего запроса — за минуты

1

Создайте токен в панели

Войдите, откройте «Открытый API», нажмите «Создать» — получите токен с префиксом qot_ (храните надёжно).

2

Вызовите API с токеном

Добавьте Authorization: Bearer qot_... и GET /api/v1/openapi/keys вернёт ваш расход в JSON.

3

Встройте в свои инструменты

Передайте ответ в скрипты, дашборды, оповещения об истечении или CI для автоматизации.

Начните с одной команды

Обычный HTTP + Bearer-токен — вызов из любого языка

Эндпоинт возвращает структурированный JSON: имя ключа, срок, сегодняшний расход и месячную квоту — готово к разбору.

  • Только чтение: запрашивает лишь ключи вашего аккаунта — без создания, изменения и трат.
  • Встроенные кеш и лимиты делают его быстрым и щадящим для вышестоящего сервиса.
# Запрос
curl -H "Authorization: Bearer qot_xxx" \
  https://qcode.cc/api/v1/openapi/keys

Пример ответа

{
  "ok": true,
  "data": {
    "keys": [{
      "name": "Pro unlimited/day",
      "is_active": true,
      "expires_at_display": "2026/08/22 21:35",
      "current_daily_cost": 42.04,
      "current_requests": 115,
      "monthly_cost_used": 8837.56,
      "monthly_cost_limit": 13000.0
    }],
    "active_api_keys": 1
  }
}

Эндпоинты

Только GET для чтения, авторизация по Bearer-токену

Эндпоинт Описание
GET /api/v1/openapi/keysСписок всех активных ключей со сроком, расходом за сегодня, квотой и загрузкой.
GET /api/v1/openapi/meСводка по аккаунту: число активных ключей и общий расход за сегодня.
GET /api/v1/openapiСамоописание: список эндпоинтов и применение, удобно для проверки доступности.

Типичные сценарии

Подключите данные о расходе к вашему рабочему процессу

Оповещения об истечении

Проверяйте срок по расписанию и автоматически шлите напоминания по email / мессенджеру / Telegram.

Дашборд расхода

Передавайте суточные расходы и загрузку квоты в Grafana, таблицы или свою панель.

Мониторинг нескольких ключей

Когда у команды несколько ключей, получайте состояние и квоту всех сразу.

CI / автоматизация

Проверяйте в пайплайне, что ключ действителен и есть квота, перед запуском дорогих ИИ-задач.

Безопасность по умолчанию

Токен — случайная строка высокой энтропии; сервер хранит только HMAC-хеш и показывает открытый текст один раз. Строго только чтение — нельзя создавать ключи или трогать баланс, со встроенными лимитами в минуту / сутки. При утечке сбросьте его одним кликом, и старый токен сразу перестанет работать.

Частые вопросы

Как получить токен доступа?

Войдите в QCode, откройте карточку «Открытый API» в панели и нажмите «Создать». Открытый токен показывается один раз — сразу скопируйте; при потере можно сбросить.

Безопасен ли токен?

Да. Он только для чтения и запрашивает лишь расход и срок ключей вашего аккаунта — без создания, изменения ключей и трат. Сервер хранит только хеш, а сброс в один клик аннулирует утёкший токен.

Есть ли ограничения частоты?

Да. У каждого токена есть лимиты в минуту и в сутки, а результаты кешируются на несколько секунд — этого хватает для обычного опроса и мониторинга. Для большей квоты обратитесь в поддержку.

Начните запрашивать расход прямо сейчас

Войдите в панель, создайте токен только для чтения и за минуты настройте оповещения и дашборды.