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

Введение

Документация спутникового API NGC3372 предназначена для разработчиков приложений, трекеров и систем анализа орбитальных данных. API базируется на сообщениях OMM (Orbit Mean-Elements Messages), исходным поставщиком которых является Celestrak.
На данный момент API предоставляется в открытом доступе. Ключи авторизации (API Key) не требуются, сбор и хранение пользовательских метаданных при запросах не осуществляется.

Во избежание избыточной нагрузки на первоисточник, API NGC3372 не обращается к серверам Celestrak напрямую, а использует настроенное зеркало с GitHub AndromedaNGC/NGC3372-API/tree/main/data, которое автоматически скачивает и позволяет агрегировать актуальные спутниковые данные каждые 12 часов.

Благодарность: Безусловно, выражаем глубокую благодарность проекту Celestrak за возможность предоставлять спутниковые данные в открытом доступе.

Список спутников

Эндпоинт api.ngc3372.ru/satellites позволяет получать перечень спутников с поддержкой фильтрации, пагинации и управления размером выборки.

Параметры запроса

Параметр	Описание	Ограничения / Пример
`page`	Номер запрашиваемой страницы.	Минимум: 1
`size`	Количество объектов на одну страницу.	Максимум: 250
`group`	Фильтрация по группе спутников. Поддерживаемые группы: active, last-30-days, noaa, stations, visual.	Пример: `active`

Структура ответа

Ответ при получении страницы выглядит следующим образом:

                            {
                            "count":                    100,
                            "items": [
                                {
                                "id":                       15018,
                                "norad_id":                 694,
                                "is_active":                true,
                                "created_at":               "2026-03-08T18:56:38.819294Z",
                                "standard_magnitude":       3.5,
                                "tags":                     ["visual"],
                                "elements": {
                                    "object_id":            "1963-047A",
                                    "object_name":          "ATLAS CENTAUR 2",
                                    "epoch":                "2026-04-25T18:26:16.292832+00:00",
                                    "mean_motion":          14.12294337,
                                    "eccentricity":         0.0546552,
                                    "inclination":          30.3531,
                                    "ra_of_asc_node":       292.5019,
                                    "arg_of_pericenter": 135.2763,
                                    "mean_anomaly": 229.3257,
                                    "ephemeris_type": 0,
                                    "classification_type": "U",
                                    "bstar": 0.00040015,
                                    "mean_motion_dot": 0.00003359,
                                    "mean_motion_ddot": 0,
                                    "rev_at_epoch": 13828,
                                    "element_set_no": 999,
                                    "updated_at": "2026-04-26T10:18:29.392571Z"
                                }
                                }
                            ],
                            "page": 1,
                            "project": "NGC3372",
                            "size": 100,
                            "total": 15548
                            }

Детальный разбор полей

Поле	Описание
`count`	Количество элементов в текущем массиве items.
`items`	Список объектов с данными о спутниках.
`norad_id`	Идентификатор в каталоге Космического командования США.
`is_active`	Флаг активности аппарата (`true` — работает, `false` — нет).
`standard_magnitude`	Стандартная звездная величина (блеск спутника).
`tags`	Список групп, в которых содержится объект (например, `["visual"]`).
`elements`	Объект с орбитальными параметрами и данными OMM.
`object_id`	Международный дизайнтор (COSPAR ID).
`object_name`	Официальное название космического объекта.
`epoch`	Дата и время актуальности данных (эпоха).
`mean_motion`	Среднее движение (число оборотов вокруг Земли в сутки).
`eccentricity`	Эксцентриситет орбиты (степень отклонения от окружности).
`inclination`	Наклонение орбиты в градусах.
`ra_of_asc_node`	Прямое восхождение восходящего узла (RAAN).
`arg_of_pericenter`	Аргумент перицентра (угол между узлом и перигеем).
`mean_anomaly`	Средняя аномалия (положение на орбите в момент эпохи).
`bstar`	Коэффициент торможения (влияние атмосферы).
`rev_at_epoch`	Номер витка на момент эпохи.
`updated_at`	Дата и время последнего обновления параметров.

Примеры использования

Активные спутники: api.ngc3372.ru/satellites?group=active
Пагинация: api.ngc3372.ru/satellites?size=200&page=3
Комбинация параметров: api.ngc3372.ru/satellites?group=active&size=200&page=3

Скоро в API

В ближайших обновлениях документации будут добавлены спецификации для эндпоинтов расчетов:

/norad/{id}/passes — Расчет пролетов (целеуказания).
/satellites/{id}/position — Текущая позиция аппарата на орбите.