Обзор API
Базовый backend — FastAPI. Интерактивная схема доступна на /api-docs, ReDoc на /api-redoc,
машиночитаемая OpenAPI 3 — на /openapi.json.
Какой интерфейс выбрать
Заголовок раздела «Какой интерфейс выбрать»| Задача | Интерфейс | Формат |
|---|---|---|
| Показать прогноз на карте | /api/forecast/catalog, /tile, /value |
JSON + PNG |
| Получить ряд для координаты | /point |
JSON |
| Лениво анализировать многомерный массив | /data |
Zarr через xpublish |
| Скачать ограниченное поле | /api/export/{id}/npy |
NumPy .npy |
| Получить EO-латент | /api/embeddings |
JSON + .npy |
| Узнать доступные модели и поля | /api/models, /api/registry |
JSON |
Имена наборов и переменных
Заголовок раздела «Имена наборов и переменных»Внутри хранилища группы используют /, например forecast/aurora15. В URL экспорта и
динамического каталога они кодируются знаком ~: forecast~aurora15.
Переменные нормализуются через реестр. Например, 2t разрешается в t2m, u10m — в
u10, а scaled_tp_1h — в tp_1h. Каталог экспорта возвращает canonical name, алиасы,
единицы и временную семантику. Это особенно важно для накопленных осадков: интервал нельзя
трактовать как мгновенное значение.
Публичная карта
Заголовок раздела «Публичная карта»Следующие маршруты read-only и не требуют пользовательского токена:
GET /api/forecast/catalog— доступныеforecast/*слои и сроки;GET /api/forecast/tile/{z}/{x}/{y}— PNG, максимальный zoom 7;GET /api/forecast/value— значение отображаемого слоя по клику.
Они ограничены картографическим представлением и не открывают сырые Zarr-массивы.