API — NIXDATA

Обзор

NIXDATA Catalog API — HTTP-сервис для машинного доступа к метаданным частного сейсморазведочного архива. По аналогии с отраслевыми решениями (Equinor oneseismic, OpenVDS API, Cognite Seismic Store) API оптимизирован для выборочного чтения описаний съёмок, политики хранения и телеметрии primary-узла — без выгрузки полных SEG-Y volume.

В России государственный контур представления геологической информации реализован через ФГИС «ЕФГИ» (Росгеолфонд, ТФГИ) с доступом через личный кабинет недропользователя и ЕСИА. NIXDATA — частный проектный архив: публичный API отдаёт только каталог и политику; бинарные материалы — по проектному токену после приглашения.

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

Уровень	Доступ	Заголовок
Публичный	`/health`, `/status`, `/metrics`, `/catalog`, `/surveys`, `/formats`, `/policy`	не требуется
Проектный	`/surveys/{id}/manifest` — список файлов выдачи	`Authorization: Bearer <token>`

Токены выдаются после проверки полномочий через форму заявки.

Публичные GET-эндпоинты: лимит 120 req/min на IP (nginx limit_req). Счётчик requests_total сохраняется между перезапусками API.

Операционные метрики

GET /api/v1/metrics — агрегированный снимок: счётчики HTTP-запросов API, статистика каталога, ingest-очередь, lag EU read-replica. Обновляется на каждый запрос.

{
  "service": "nixdata-catalog-api",
  "http": { "requests_total": 0, "requests_per_minute": 0, "endpoints": {} },
  "catalog": { "surveys_online": 5, "surveys_total": 10, "trace_records_total": 152362000 },
  "ingest": { "queue_jobs": 2, "queue_gb": 840, "qc_pass_rate_pct": 97.8 },
  "replication": { "lag_sec": 612, "sync_status": "synced" }
}

Эндпоинты

GET/api/v1/health

Состояние API-процесса и версия сервиса.

GET/api/v1/status

Телеметрия primary catalog node: uptime, load, CPU cores, memory/swap, disk, сеть, archive_stats, operational (ingest/replication).

GET/api/v1/catalog

Полный документ каталога: primary/mirror sites, formats, surveys, policy. Legacy alias: /api/catalog.json.

GET/api/v1/surveys?status=online&kind=3D-volume

Список съёмок с фильтрами status (online · archived · processing), kind (2D-line · 3D-volume · 4D-monitor · navigation · well-tie · potential-fields).

GET/api/v1/surveys/{id}

Метаданные одной съёмки (CRS, trace_count, processing_stage, replication).

GET/api/v1/surveys/{id}/headers

Публичное summary SEG-Y textual header (без бинарных трасс).

GET/api/v1/surveys/{id}/manifest

Манифест файлов выдачи. Без Bearer-токена возвращает 401.

POST/api/v1/inquiries

Заявка на доступ (форма на /contacts.html). Сохраняется на MSK-1, почтовый сервер не требуется.

GET/api/v1/formats · /api/v1/policy

Реестр форматов (SEG-Y, SPS, LAS…) и документ политики residency/export.

Пример (curl)

curl -sS https://nixdata.ru/api/v1/surveys?status=online | jq .
curl -sS https://nixdata.ru/api/v1/surveys/3D-VLG-2021-003/headers | jq .
curl -sS -H "Authorization: Bearer <project-token>" \
  https://nixdata.ru/api/v1/surveys/3D-VLG-2021-003/manifest | jq .

Правовая база (API)

Политика и ссылки на нормативные акты доступны в /api/v1/policy (поле legal_references). Человекочитаемый перечень — на странице Правовая база.

Сравнение с отраслевыми моделями

Контур	Назначение	Доступ
ФГИС ЕФГИ / Росгеолфонд	Государственный фонд ГИ о недрах, представление комплектов недропользователями	ЕСИА, личный кабинет, разрешение Роснедр
ТФГИ / Моргеобанк	Территориальные и морские фонды, реестр работ по ГИН	Заявка, цель запроса, перечень документов
OpenVDS / oneseismic	Cloud-native доступ к slices/fences 3D volume	Корпоративная авторизация, SDK/API
NIXDATA	Частный проектный архив + EU read-replica по договору	Invite-only; публичный API — metadata only