Перейти к содержанию

Обзор Analytics API 📈

Весь раздел аналитики Gifty переведен на GraphQL. Это позволяет фронтенду запрашивать именно те данные, которые необходимы для конкретного дашборда, минимизируя нагрузку на сервер.

API выступает в роли защищенного прокси между внутренним дашбордом и системами сбора данных (PostHog, Prometheus, PostgreSQL).

Аутентификация

Все запросы к Analytics GraphQL API требуют передачи токена доступа в заголовке X-Analytics-Token.

Заголовок Описание
X-Analytics-Token Секретный токен, заданный в настройках (ANALYTICS_API_TOKEN).

Эндпоинт

Все запросы направляются на единый эндпоинт: - URL: /api/v1/analytics/graphql - Метод: POST (или GET для доступа к GraphiQL в браузере)

Кэширование

Для снижения нагрузки на внешние сервисы используется Redis:

  • Поведенческие данные (PostHog): 5-10 минут.
  • Технические метрики (Prometheus): 1 минута.
  • Здоровье системы (PostgreSQL): 5 минут.