/api/astro/sign_transitions/1 кредитПереходи між знаками
Усі моменти за рік, коли планета переходить з одного сидеричного знака в наступний, — в індійській астрології це гочар, а для Сонця — санкранті. Дванадцять переходів Сонця відмічають сонячні місяці, на переходах Юпітера й Сатурна тримаються довгострокові прогнози, а Місяць змінює знак кожні два з половиною дні. Надішліть `year` і `timezone_as_float`. Відповідь — `data.planets`: об’єкт, де ключі — назви планет, а значення — списки `{from_sign, to_sign, datetime}` у порядку дат. Охоплено дванадцять тіл: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, truenode і meannode. Зверніть увагу: місячні вузли подано під цими двома назвами, а не як rahu і ketu. Мітки часу — в UTC, а сам момент переходу однаковий для всієї Землі. Надіслане зміщення визначає, який місцевий календарний рік охоплює сканування: так перехід пізно ввечері 31 грудня за UTC для користувача в Індії правильно потрапляє в наступний рік. Для відображення переведіть час у місцевий. Переходи шукають день за днем, а потім уточнюють у межах дня, тож час визначається з точністю до малої частки градуса. Лише Місяць дає понад 150 записів на рік, тож відповідь буде чималою. Ті самі дані є в `/api/planetary_details/` поряд із вісьмома іншими розрахунками; цей ендпоінт повертає лише переходи.
https://api.occultapi.com/api/astro/sign_transitions/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| year | integer | обов’язковий | Рік народження числом, напр. 1990. Чотири цифри. min 1800 · max 2400 |
| timezone_as_float | number (double) | необов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/sign_transitions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026,"timezone_as_float":5.5}'Відповідь
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"planets\": {\"sun\": [{\"from_sign\": \"Sagittarius\", \"to_sign\": \"Capricorn\", \"datetime\": \"2026-01-14 09:38:26\"}, {\"from_sign\": \"Capricorn\", \"to_sign\": \"Aquarius\", \"datetime\": \"2026-02-12 22:40:18\"}, {\"from_sign\": \"Aquarius\", \"to_sign\": \"Pisces\", \"datetime\": \"2026-03-14 19:31:52\"}, {\"from_sign\": \"Pisces\", \"to_sign\": \"Aries\", \"datetime\": \"2026-04-14 04:03:45\"}, {\"from_sign\": \"Aries\", \"to_sign\": \"Taurus\", \"datetime\": \"2026-05-15 00:52:30\"}, {\"from_sign\": \"Taurus\", \"to_sign\": \"Gemini\", \"datetime\": \"2026-06-15 07:23:26\"}, {\"from_sign\": \"Gemini\", \"to_sign\": \"Cancer\", \"datetime\": \"2026-07-16 18:10:18\"}, {\"from_sign\": \"Cancer\", \"to_sign\": \"Leo\", \"datetime\": \"2026-08-17 02:28:07\"}, {\"from_sign\": \"Leo\", \"to_sign\": \"Virgo\", \"datetime\": \"2026-09-17 02:22:30\"}, {\"from_sign\": \"Virgo\", \"to_sign\": \"Libra\", \"datetime\": \"2026-10-17 14:22:30\"}, {\"from_sign\": \"Libra\", \"to_sign\": \"Scorpio\", \"datetime\": \"2026-11-16 14:14:03\"}, {\"from_sign\": \"Scorpio\", \"to_sign\": \"Sagittarius\", \"datetime\": \"2026-12-16 04:54:22\"}], \"moon\": [{\"from_sign\": \"Taurus\", \"to_sign\": \"Gemini\", \"datetime\": \"2026-01-02 03:56:00\"}, {\"from_sign\": \"Gemini\", \"to_sign\": \"Cancer\", \"datetime\": \"2026-01-04 04:13:14\"}, {\"from_sign\": \"Cancer\", \"to_sign\": \"Leo\", \"datetime\": \"2026-01-06 06:47:55\"}, {\"from_sign\": \"Leo\", \"to_sign\": \"Virgo\", \"datetime\": \"2026-01-08 13:09:22\"}, {\"from_sign\": \"Virgo\", \"to_sign\": \"Libra\", \"datetime\": \"2026-01-10 23:22:40\"}, {\"from_sign\": \"Libra\", \"to_sign\": \"Scorpio\", \"datetime\": \"2026-01-13 11:51:19\"}, {\"from_sign\": \"Scorpio\", \"to_sign\": \"Sagittarius\", \"datetime\": \"2026-01-16 00:17:52\"}, {\"from_sign\": \"Sagittarius\", \"to_sign\": \"Capricorn\", \"datetime\": \"2026-01-18 11:11:15\"}, {\"from_sign\": \"Capricorn\", \"to_sign\": \"Aquarius\", \"datetime\": \"2026-01-20 20:05:37\"}, {\"from_sign\": \"Aquarius\", \"to_sign\": \"Pisces\", \"datetime\": \"2026-01-23 03:03:48\"}, {\"from_sign\": \"Pisces\", \"to_sign\": \"Aries\", \"datetime\": \"2026-01-25 08:05:58\"}, {\"from_sign\": \"Aries\", \"to_sign\": \"Taurus\", \"datetime\": \"2026-01-27 11:15:07\"}, {\"from_sign\": \"Taurus\", \"to_sign\": \"Gemini\", \"datetime\": \"2026-01-29 13:01:06\"}, {\"from_sign\": \"Gemini\", \"to_sign\": \"Cancer\", \"datetime\": \"2026-01-31 14:31:17\"}, {\"from_sign\": \"Cancer\", \"to_sign\": \"Leo\", \"datetime\": \"2026-02-02 17:17:55\"}, {\"from_sign\": \"Leo\", \"to_sign\": \"Virgo\", \"datetime\": \"2026-02-04 22:50:09\"}, {\"from_sign\": \"Virgo\", \"to_sign\": \"Libra\", \"datetime\": \"2026-02-07 07:51:54\"}, {\"from_sign\": \"Libra\", \"to_sign\": \"Scorpio\", \"datetime\": \"2026-02-09 19:41:22\"}, {\"from_sign\": \"Scorpio\", \"to_sign\": \"Sagittarius\", \"datetime\": \"2026-02-12 08:12:28\"}, {\"from_sign\": \"Sagittarius\", \"to_sign\": \"Capricorn\", \"datetime\": \"2026-02-14 19:12:32\"}, {\"from_sign\": \"Capricorn\", \"to_sign\": \"Aquarius\", \"datetime\": \"2026-02-17 03:35:58\"}, {\"from_sign\": \"Aquarius\", \"to_sign\": \"Pisces\", \"datetime\": \"2026-02-19 09:30:10\"}, {\"from_sign\": \"Pisces\", \"to_sign\": \"Aries\", \"datetime\": \"2026-02-21 13:37:19\"}, {\"from_sign\": \"Aries\", \"to_sign\": \"Taurus\", \"datetime\": \"2026-02-23 16:42:35\"}, {\"from_sign\": \"Taurus\", \"to_sign\": \"Gemini\", \"datetime\": \"2026-02-25 19:24:50\"}, {\"from_sign\": \"Gemini\", \"to_sign\": \"Cancer\", \"datetime\": \"2026-02-27 22:22:33\"}, {\"from_sign\": \"Cancer\", \"to_sign\": \"Leo\", \"datetime\": \"2026-03-02 02:21:37\"}, {\"from_sign\": \"Leo\", \"to_sign\": \"Virgo\", \"datetime\": \"2026-03-04 08:15:49\"}, {\"from_sign\": \"Virgo\", \"to_sign\": \"Libra\", \"datetime\": \"2026-03-06 16:48:55\"}, {\"from_sign\": \"Libra\", \"to_sign\": \"Scorpio\", \"datetime\": \"2026-03-09 03:59:52\"}, {\"from_sign\": \"Scorpio\", \"to_sign\": \"Sagittarius\", \"datetime\": \"2026-03-11 16:30:28\"}, {\"from_sign\": \"Sagittarius\", \"to_sign\": \"Capricorn\", \"datetime\": \"2026-03-14 04:03:13\"}, {\"from_sign\": \"Capricorn\", \"to_sign\": \"Aquarius\", \"datetime\": \"2026-03-16 12:44:24\"}, {\"from_sign\": \"Aquarius\", \"to_sign\": \"Pisces\", \"datetime\": \"2026-03-18 18:06:16\"}, {\"from_sign\": \"Pisces\", \"to_sign\": \"Aries\", \"datetime\": \"2026-03-20 20:58:00\"}, {\"from_sign\": \"Aries\", \"to_sign\": \"Taurus\", \"datetime\": \"2026-03-22 22:44:10\"}, {\"from_sign\": \"Tau"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.