Документация

API v2.4

Быстрый старт

API Gamma Space управляет пайплайнами, источниками и приёмниками. События отправляются по HTTP или через SDK на ingest.gammaspace.io.

1. Создайте пайплайн

В консоли выберите «Новый пайплайн» и укажите схему события. Схему можно добавить позже.

2. Отправьте событие

Используйте HTTP-эндпоинт или SDK. Ключ приёма выдаётся в настройках источника.

3. Подключите приёмник

Укажите S3, ClickHouse или вебхук. Доставка начнётся сразу после сохранения.

Все примеры используют переменную окружения GAMMA_TOKEN. Не храните ключи в репозитории.

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

Передавайте ключ в заголовке Authorization. Ключ привязан к проекту и роли: для чтения достаточно read, для изменений — write.

terminal — проверка ключа

curl -s https://api.gammaspace.io/v1/pipelines \
  -H "Authorization: Bearer $GAMMA_TOKEN" \
  -H "Accept: application/json"

Эндпоинты

Базовый адрес: https://api.gammaspace.io. Все ответы в JSON, коды ошибок описаны ниже.

GET

/v1/pipelines

Список пайплайнов и состояние доставки.

POST

/v1/pipelines

Создание пайплайна с фильтрами и приёмником.

GET

/v1/sources

Источники и их пропускная способность.

POST

/v1/transforms

Добавление преобразования или маскирования.

GET

/v1/usage

Расход событий по источникам и дням.

Пример запроса

Создание объекта в регионе eu-central. Ответ содержит идентификатор и состояние обработки.

terminal — create

curl -s -X POST https://api.gammaspace.io/v1/pipelines \
  -H "Authorization: Bearer $GAMMA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "first", "region": "eu-central"}'

Ошибки

Ошибки возвращаются с машиночитаемым полем code и человекочитаемым message.

400	Событие не прошло валидацию по схеме.
401	Ключ приёма неверный или отозван.
413	Размер события превышает 1 МБ.
429	Превышен лимит событий в секунду для источника.

SDK и интеграции

Официальные SDK и готовые коннекторы. Если нужного нет — используйте HTTP API, он полностью документирован.

KafkaClickHouseBigQueryS3SnowflakeTerraformGrafanaOpenTelemetry

История версий

v2.4 — текущая версия API. Совместима с предыдущей, изменения только аддитивные.

Обновлены примеры и описания ошибок.
Добавлены поля состояния и времени обновления.
Gamma Space 2.4: дедупликация и новые регионы — подробности релиза.

Помощь

Не нашли ответ? Поддержка отвечает в рабочие часы, а дежурный инженер — круглосуточно при инцидентах.

Написать в поддержку