Версия 2.3

API альманаха

Открытый JSON API без ключей. Все ответы считаются на сервере в момент запроса, ограничение 10 запросов в секунду с одного адреса. Спецификация лежит в OpenAPI.

Ошибки

Ошибки приходят с понятным кодом HTTP и единым телом:

{"error": {"code": "invalid_parameter", "message": "Укажите lat и lon или city", "param": "lat", "request_id": "…"}}

GET/api/v1/status

Состояние сервиса

/api/v1/status

GET/api/v1/time

Время: UTC, юлианская дата, звёздное время

/api/v1/time

GET/api/v1/locations

Города с координатами и часовым поясом

/api/v1/locations

GET/api/v1/sun

Положение Солнца, восход, закат и сумерки

Параметры: city, lat, lon, tz, date, at

/api/v1/sun?city=moscow

GET/api/v1/moon

Положение и фаза Луны, ближайшие фазы

Параметры: city, lat, lon, tz, date, at

/api/v1/moon?lat=55.75&lon=37.62&tz=3

GET/api/v1/planets

Меркурий, Венера, Марс, Юпитер и Сатурн

Параметры: city, lat, lon, tz, at

/api/v1/planets?city=singapore

GET/api/v1/stars

Каталог ярких звёзд, с фильтром по созвездию

Параметры: constellation, city, lat, lon, min_altitude, limit, at

/api/v1/stars?constellation=Dra&city=tbilisi&min_altitude=0

GET/api/v1/sky

Сводка: Солнце, Луна, планеты и видимые звёзды

Параметры: city, lat, lon, tz, date, at

/api/v1/sky?city=novosibirsk

GET/api/v1/events

Астрономические события

Параметры: from, type, limit

/api/v1/events?type=meteors&limit=3