Перейти до вмісту
Occult API
POST/api/astro/retrograde/1 кредит

Ретроградні періоди

Усі ретроградні періоди за рік в одній невеликій відповіді. Ретроградний рух, або вакрі, — це видимий зворотний рух планети на тлі зір; в астрологічній практиці такі проміжки вважають окремою фазою в поведінці планети. Надішліть лише `year`. Відповідь — `data.planets`: об’єкт, де ключі — назви планет, а значення — списки міток часу `{start, end}` в UTC. Періоди, що переходять через межу року, обрізаються до 1 січня та 31 грудня, тож вікно, яке починається о `01-01 00:00:00`, насправді почалося ще в попередньому році. Якщо планета за рік жодного разу не стає ретроградною, її список порожній. Повертається десять ключів: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu і ketu. Сонця й Місяця немає, бо з Землі вони ніколи не бувають ретроградними. Раху й Кету обчислюються за середнім місячним вузлом, який увесь рік рівномірно рухається назад без станцій, тому в обох завжди одне вікно на весь рік; з істинним вузлом з’явилися б десятки хибних записів по кілька днів. Моменти станцій шукають так: спершу визначають день, у який швидкість за довготою змінює знак, а потім уточнюють момент у межах цього дня, тож похибка значно менша за хвилину. Ті самі дані є в `/api/planetary_details/` разом із вісьмома іншими розрахунками; цей ендпоінт повертає лише дані про ретроградність.

https://api.occultapi.com/api/astro/retrograde/
Спробувати запит
Результат «Ретроградні періоди» в інтерфейсі
Дані цього ендпоінта в живому інтерфейсі. API повертає значення, а вигляд сторінки ви будуєте самі.

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

ПолеТипОбов’язковеПримітки
yearintegerобов’язковий

Рік народження числом, напр. 1990. Чотири цифри.

min 1800 · max 2400

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

Відповідь

{
  "data": {
    "year": 2026,
    "planets": {
      "mercury": [
        {
          "start": "2026-02-26 06:47:34",
          "end": "2026-03-20 19:33:02"
        },
        {
          "start": "2026-06-29 17:34:35",
          "end": "2026-07-23 22:58:49"
        },
        {
          "start": "2026-10-24 07:12:44",
          "end": "2026-11-13 15:54:27"
        }
      ],
      "venus": [
        {
          "start": "2026-10-03 07:13:14",
          "end": "2026-11-14 00:29:50"
        }
      ],
      "mars": [],
      "jupiter": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-03-11 03:53:41"
        },
        {
          "start": "2026-12-13 00:30:39",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "saturn": [
        {
          "start": "2026-07-26 18:57:26",
          "end": "2026-12-11 00:30:23"
        }
      ],
      "uranus": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-02-04 02:56:33"
        },
        {
          "start": "2026-09-10 18:24:34",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "neptune": [
        {
          "start": "2026-07-07 09:57:49",
          "end": "2026-12-13 00:46:51"
        }
      ],
      "pluto": [
        {
          "start": "2026-05-06 12:13:55",
          "end": "2026-10-16 05:33:46"
        }
      ],
      "rahu": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "ketu": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-12-31 00:00:00"
        }
      ]
    }
  },
  "message": "successful",
  "is_error": false
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.