IZI API: обзор для разработчиков

IZI API: обзор для разработчиков

IZI API — GraphQL-интерфейс для интеграции внешних систем с платформой управления компьютерным клубом. Через него партнёры подключают кассовые системы, платёжные шлюзы, мобильные приложения и кастомные дашборды.

Один endpoint, один протокол — никаких множественных REST-ресурсов.

Архитектура

Клиент (партнёр)
      │
      │  POST https://api.izi.is/graphql
      │  Authorization: Bearer <jwt_token>
      ▼
  GraphQL Gateway
      │
      ├── Clubs & Zones
      ├── Sessions & Devices
      ├── Clients & Balances
      ├── Tariffs & Payments
      ├── Analytics
      └── Webhooks

Все операции — через единый endpoint. Запросы (query) читают данные, мутации (mutation) изменяют состояние, подписки (subscription) — потоковые события в реальном времени.

Базовый запрос

curl -X POST https://api.izi.is/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"query": "{ me { id email } }"}'

Ответ всегда в формате { "data": {...}, "errors": [...] }. Если errors присутствует — запрос выполнен частично или отклонён.

Что доступно через API

Домен	Примеры операций
Авторизация	loginWithEmailPassword, refreshToken
Клубы	clubs, club, createClub, updateClub
Устройства	devices, deviceStatus, updateDevice
Сессии	activeSessions, startSession, endSession
Клиенты	clients, clientByPhone, topUpBalance
Тарифы	tariffs, purchaseTariff
Аналитика	analyticsRevenue, analyticsOccupancy
Вебхуки	createWebhook, webhooks, deleteWebhook

Версионирование

IZI API не использует URL-версионирование (/v1/, /v2/). Изменения вносятся через deprecation: старые поля помечаются @deprecated с указанием замены, новые добавляются параллельно. Перед удалением поля команда IZI уведомляет партнёров за 30 дней.

Проверить статус поля:

{
  __type(name: "Session") {
    fields {
      name
      isDeprecated
      deprecationReason
    }
  }
}

Лимиты и доступность

• Ограничение частоты: 100 запросов / 10 секунд на токен (подробнее — Ограничения частоты запросов)
• Доступность: 99,9% SLA для production-кластера
• Регион: EU (Frankfurt) — основной, UAE — дополнительный

Следующие шаги

• Основы GraphQL в IZI — как строить запросы
• Авторизация и токены — получение и обновление JWT
• Webhooks — подписка на события в реальном времени
• Примеры SDK — готовый код на JS и Python

См. также

• Коды ошибок IZI API
• Основы GraphQL в IZI
• Авторизация и токены IZI API
• Ограничения частоты запросов IZI API
• Примеры SDK IZI: JavaScript и Python