Engine101 Meteo API v1
Базовый URL: https://api.engine101.tech. Ответы — JSON (UTF-8), для выгрузок по полигону доступен format=geojson. Время во всех ответах — ISO 8601 с часовым поясом точки.
Ключ доступа
Каждый запрос содержит заголовок X-Api-Key. Ключ привязан к тарифу; тестовый ключ выдаётся по письму на support@engine101.tech.
Лимиты
Лимит считается по ключу за скользящие сутки. Текущий остаток — в заголовках ответа:
При превышении возвращается 429 с полем retry_after (секунды).
Ошибки
| Код | error | Описание |
|---|---|---|
| 400 | bad_coordinates | Координаты вне зоны покрытия или неверный формат |
| 401 | invalid_key | Ключ не передан или отозван |
| 403 | plan_restricted | Метод недоступен на текущем тарифе |
| 429 | rate_limited | Превышен суточный лимит |
| 503 | source_unavailable | Нет свежих данных станции, повторите позже |
Единицы
Параметр units: metric (по умолчанию: °C, м/с, гПа, мм) или imperial (°F, mph, inHg, in).
GET /v1/current
Текущие наблюдения в точке. Если ближайшая станция дальше 25 км, значения интерполируются, а поле source принимает значение grid.
| Параметр | Тип | Описание |
|---|---|---|
lat, lon | float | Координаты точки (WGS 84) |
units | string | metric | imperial |
lang | string | ru | kk | en — язык описания погоды |
GET /v1/forecast
Почасовой прогноз. hours — от 1 до 240 (на тестовом тарифе до 72).
GET /v1/air
Концентрации загрязнителей (мкг/м³) и сводный AQI. Данные городских датчиков усредняются за последний час.
estimated: true.POST /v1/archive/export
Асинхронная выгрузка наблюдений. Тело запроса:
Ответ содержит job_id; статус задачи — через GET /v1/archive/jobs/{id}.
GET /v1/archive/jobs/{id}
Статусы: queued, running, done (с полем url, ссылка действует 24 часа), failed.