/api/astro/chart_analysis/1 кредитАналіз карти
Чотирнадцять структурних показників натальної карти одним викликом, а також одне порівняння натальної карти з транзитною. Це інтерпретаційний рівень над /api/astro/chart/: він дає не самі положення, а те, що з них випливає. Набір полів у відповіді завжди однаковий. `house_from_reference_chart` — номер дому, у який потрапляє `target_celestial` транзитної карти, якщо відлічувати від `ref_celestial` натальної карти. `kendras` групує натальні тіла за кутовими домами. `argala` і `virodhargala` для кожного тіла дають планети, що втручаються та перешкоджають, з ключами відповідно 2-й, 4-й, 5-й і 11-й та 12-й, 10-й, 9-й і 3-й. `bhava_arudhas` і `ghara_arudhas` — проєкції домів і планет. `temporary_relationships` і `compound_relationships` — дружні стосунки планет, властиві саме цій карті. `karakas` — чара-караки, `nakshatra_count` — відстань у накшатрах від опорного тіла, а `exaltation`, `debilitation`, `mooltrikona`, `own_rashi` і `pachakadi_relations` — перевірки гідності. Обидві карти — завжди карти раші: `chart_name_natal` і `chart_name_transit` — довільні мітки, і, попри назви, дробову карту вони не обирають. `mode` задає вісім чи сім чара-карак, а `rahu` — істинні чи середні вузли, лише для блоку карак. `ref_celestial` можна встановити в 'ascendant'; тоді два поля стосунків, які за визначенням описують пари планет, повертають null.
https://api.occultapi.com/api/astro/chart_analysis/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| chart_name_natal | string | обов’язковий | ДОВІЛЬНА мітка, а НЕ вибір типу карти. Попри назву, цей ендпоінт завжди будує RashiChart; рядок зберігається лише як підпис для відображення й ніколи не перевіряється. Підійде будь-який непорожній рядок. |
| chart_name_transit | string | обов’язковий | ДОВІЛЬНА мітка, а НЕ вибір типу карти. Те саме, що chart_name_natal. |
| date_time_natal | string (date-time) | обов’язковий | Обмеження ФОРМАТУ. DRF DateTimeField: лише ISO-8601 (типові формати введення DRF), напр. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" або "2026-09-01 06:00:00" (без часового поясу вважається UTC). |
| date_time_transit | string (date-time) | обов’язковий | Обмеження ФОРМАТУ. DRF DateTimeField: лише ISO-8601 (типові формати введення DRF), напр. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" або "2026-09-01 06:00:00" (без часового поясу вважається UTC). |
| latitude_natal | number (double) | обов’язковий | min -180 · max 180 |
| latitude_transit | number (double) | обов’язковий | min -180 · max 180 |
| longitude_natal | number (double) | обов’язковий | min -180 · max 180 |
| longitude_transit | number (double) | обов’язковий | min -180 · max 180 |
| mode | integer | обов’язковий | 78Ціле число, а не рядок, але з обмеженням: 8 — вісім чара-карак (разом із Пітрі-каракою та Раху), 7 — сім карак (без Раху). Мають сенс лише 7 і 8. |
| rahu | string | обов’язковий | truemeanЗ урахуванням регістру, у нижньому регістрі. Явно перевіряється лише 'true'; будь-яке інше значення (зокрема 'mean') потрапляє в гілку else і поводиться як 'mean'. Впливає лише на блок `karakas`. |
| ref_celestial | string | обов’язковий | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannodeЗ урахуванням регістру, усе в нижньому регістрі. 'ascendant' працює для частин house_from_reference_chart і nakshatra_count; коли ref_celestial='ascendant', поля temporary_relationships і compound_relationships навмисно повертають null. Нерозпізнана назва повертає 400 (KeyError). |
| target_celestial | string | обов’язковий | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannodeТой самий набір значень, що й для ref_celestial. |
| bhava_arudha_exceptions | boolean | необов’язковий | |
| graha_arudha_exceptions | boolean | необов’язковий | |
| nakshatras | string | необов’язковий |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/chart_analysis/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time_natal":"2025-11-21T05:45:23.715Z","date_time_transit":"2024-11-21T05:45:23.715Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"mercury","target_celestial":"mars","rahu":"true","mode":0}'Відповідь
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"house_from_reference_chart\": {\"house_from_ref\": 9, \"zodiac_sign_in_ref\": \"Cn\"}, \"kendras\": [[\"venus\", \"jupiter\", \"pluto\"], [\"sun\", \"moon\", \"mercury\", \"mars\", \"uranus\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], [\"saturn\", \"neptune\"]], \"argala\": {\"sun\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"moon\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"mercury\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"venus\": {\"2\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"4\": [\"pluto\"], \"5\": [\"northtruenode\", \"northmeannode\"], \"11\": [\"southtruenode\", \"southmeannode\"]}, \"mars\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"jupiter\": {\"2\": [\"southtruenode\", \"southmeannode\"], \"4\": [\"venus\"], \"5\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"11\": [\"uranus\"]}, \"saturn\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"uranus\": {\"2\": null, \"4\": [\"southtruenode\", \"southmeannode\"], \"5\": null, \"11\": [\"saturn\", \"neptune\"]}, \"neptune\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"pluto\": {\"2\": [\"northtruenode\", \"northmeannode\"], \"4\": null, \"5\": [\"uranus\"], \"11\": [\"sun\", \"moon\", \"mercury\", \"mars\"]}, \"northtruenode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"northmeannode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"southtruenode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}, \"southmeannode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}}, \"virodhargala\": {\"sun\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"moon\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"mercury\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"venus\": {\"3\": null, \"9\": null, \"10\": [\"jupiter\"], \"12\": null}, \"mars\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"jupiter\": {\"3\": null, \"9\": [\"saturn\", \"neptune\"], \"10\": null, \"12\": null}, \"saturn\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"uranus\": {\"3\": [\"jupiter\"], \"9\": [\"pluto\"], \"10\": [\"northtruenode\", \"northmeannode\"], \"12\": null}, \"neptune\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"pluto\": {\"3\": [\"saturn\", \"neptune\"], \"9\": null, \"10\": [\"venus\"], \"12\": null}, \"northtruenode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"northmeannode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"southtruenode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}, \"southmeannode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}}, \"bhava_arudhas\": {\"A1\": \"Taurus\", \"A2\": \"Aries\", \"A3\": \"Scorpio\", \"A4\": \"Gemini\", \"A5\": \"Pisces\", \"A6\": \"Aries\", \"A7\": \"Pisces\", \"A8\": \"Scorpio\", \"A9\": \"Capricorn\", \"A10\": \"Cancer\", \"A11\": \"Leo\", \"A12\": \"Aquarius\"}, \"ghara_arudhas\": {\"A1\": \"Leo\", \"A2\": \"Leo\", \"A3\": \"Leo\", \"A4\": \"Cancer\", \"A5\": \"Leo\", \"A6\": \"Pisces\", \"A7\": \"Scorpio\", \"A8\": \"Pisces\", \"A9\": \"Scorpio\", \"A10\": \"Taurus\", \"A11\": \"Aries\", \"A12\": \"Aries\"}, \"temporary_relationships\": {\"friends\": [\"venus\", \"pluto\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], \"enemies\": [\"sun\", \"moon\", \"mars\", \"jupiter\", \"saturn\", \"uranus\", \"neptune\"]}, \"compound_relationships\": \"Satru\", \"karakas\": {\"ak\": {\"venus\": {\"degree\": 23, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 43}}, \"amk\": {\"mars\": {\"degree\": 17, \"sign\": \"Sc\", \"minutes\": 52, \"seconds\": 44}}, \"bk\": {\"moon\": {\"degree\": 15, \"sign\": \"Sc\", \"minutes\": 20, \"seconds\": 27}}, \"mk\": {\"northtruenode\""
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.