Engine101 Meteo API v1

Базовый URL: https://api.engine101.tech. Ответы — JSON (UTF-8), для выгрузок по полигону доступен format=geojson. Время во всех ответах — ISO 8601 с часовым поясом точки.

Ключ доступа

Каждый запрос содержит заголовок X-Api-Key. Ключ привязан к тарифу; тестовый ключ выдаётся по письму на support@engine101.tech.

X-Api-Key: e101_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Лимиты

Лимит считается по ключу за скользящие сутки. Текущий остаток — в заголовках ответа:

X-RateLimit-Limit: 50000 X-RateLimit-Remaining: 48712 X-RateLimit-Reset: 2026-11-13T00:00:00+05:00

При превышении возвращается 429 с полем retry_after (секунды).

Ошибки

КодerrorОписание
400bad_coordinatesКоординаты вне зоны покрытия или неверный формат
401invalid_keyКлюч не передан или отозван
403plan_restrictedМетод недоступен на текущем тарифе
429rate_limitedПревышен суточный лимит
503source_unavailableНет свежих данных станции, повторите позже

Единицы

Параметр units: metric (по умолчанию: °C, м/с, гПа, мм) или imperial (°F, mph, inHg, in).

GET /v1/current

Текущие наблюдения в точке. Если ближайшая станция дальше 25 км, значения интерполируются, а поле source принимает значение grid.

ПараметрТипОписание
lat, lonfloatКоординаты точки (WGS 84)
unitsstringmetric | imperial
langstringru | kk | en — язык описания погоды

GET /v1/forecast

Почасовой прогноз. hours — от 1 до 240 (на тестовом тарифе до 72).

curl -s 'https://api.engine101.tech/v1/forecast?lat=51.1694&lon=71.4491&hours=24' \ -H 'X-Api-Key: <KEY>' { "location": "Астана", "hourly": [ { "t": "2026-11-12T10:00:00+05:00", "temp_c": -6.2, "wind_ms": 5.8, "precip_mm": 0 }, { "t": "2026-11-12T11:00:00+05:00", "temp_c": -5.4, "wind_ms": 6.3, "precip_mm": 0.2 } ] }

GET /v1/air

Концентрации загрязнителей (мкг/м³) и сводный AQI. Данные городских датчиков усредняются за последний час.

Для населённых пунктов без датчиков возвращается модельная оценка, поле estimated: true.

POST /v1/archive/export

Асинхронная выгрузка наблюдений. Тело запроса:

{ "station": "36870", "from": "2024-01-01", "to": "2024-12-31", "fields": ["temp_c", "precip_mm"], "format": "parquet" }

Ответ содержит job_id; статус задачи — через GET /v1/archive/jobs/{id}.

GET /v1/archive/jobs/{id}

Статусы: queued, running, done (с полем url, ссылка действует 24 часа), failed.