WEATHER API / REFERENCE

Полный
справочник API.

Все endpoint, параметры запросов и правила работы с опубликованным прогнозом.

АВТОРИЗАЦИЯ

Один ключ — все запросы

Создайте API-ключ в личном кабинете и передавайте его в заголовке. Секрет ключа показывается только один раз.

HTTP

Authorization: ApiKey eol_your_secret_key

ENDPOINTS

Три базовых запроса

GET/api/v1/metadata/

Версия набора, доступные параметры, покрытие, период прогноза и атрибуция источника.

GET/api/v1/point/

Значения параметров в одной точке на точный срок опубликованного прогноза.

GET/api/v1/series/

Временной ряд для точки с постраничной выдачей.

ПАРАМЕТРЫ ЗАПРОСА

Что передавать в запросе

Параметр	Где используется	Описание
`latitude`	point, series	Широта в градусах, от −90 до 90.
`longitude`	point, series	Долгота в границах покрытия опубликованного набора.
`time`	point	Точный срок в UTC, например 2026-08-03T00:00:00Z.
`start`, `end`	series	Начало и конец ряда в UTC; оба срока должны быть доступны в наборе.
`parameters`	point, series	Коды через запятую. Если не передать, API вернёт все доступные поля.
`interpolation`	point, series	`nearest` (по умолчанию) или `linear` для билинейной интерполяции по координатам.
`page`, `page_size`	series	Страница и размер страницы; максимум — 500 результатов.

ОТВЕТЫ И ОШИБКИ

Как читать результат

JSON

{
  "time": "2026-08-03T00:00:00Z",
  "latitude": 55.75,
  "longitude": 37.62,
  "dataset_id": "…",
  "values": {"surface.air_temperature_2m": {"value": 281.4, "unit": "K"}}
}

400

Неверные координаты, код параметра или время вне опубликованной временной оси.

401

Нет API-ключа, ключ неверный или отозван.

429

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

Открыть интерактивный Swagger ↗