/api/astro/saptamsa/1 кредитСаптамша (D7)
Саптамша, сьома дробова карта: кожен знак поділено на сім частин приблизно по 4°17'. Розглядають щодо дітей і нащадків. Повертає ту саму пласку структуру, що й /api/astro/planet-positions/: планети списком у традиційному порядку, у кожної — `name`, довгота, знак, накшатра, пада й дім, а також асцендент і застосована аянамша. Надішліть дату й місце; `ayanamsa` за замовчуванням — LAHIRI, приймаються всі 48. Карту задає маршрут, тому `chart_name` у тілі запиту ігнорується: цей ендпоінт не може повернути нічого, крім карти, вказаної в його назві. Інші 24 поділи повертає /api/astro/chart/.
https://api.occultapi.com/api/astro/saptamsa/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| chart_name | string | обов’язковий | |
| datetime | string (date-time) | обов’язковий | Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC. Те саме значення, що й date_time, — інші ендпоінти називають це поле інакше. |
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -89.9 · max 89.9 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| aberration | boolean | необов’язковий | |
| apply_correction | boolean | необов’язковий | |
| ascendant_pos | string | необов’язковий | cuspstartend |
| ayanamsa | string | необов’язковий | |
| background_color | string | необов’язковий | Колір фону SVG у форматі hex. |
| chart_style | string | необов’язковий | Стиль діаграми, коли render='svg'. 'north' — ромбоподібний макет із фіксованими домами та змінним розташуванням знаків; 'south' — сітка з фіксованими знаками та змінним розташуванням домів. northsouth |
| correction_deg | integer | необов’язковий | min 0 |
| correction_direction | string | необов’язковий | addsubtract |
| correction_min | integer | необов’язковий | min 0 · max 59 |
| correction_sec | integer | необов’язковий | min 0 · max 59 |
| extended_bodies | array | необов’язковий | Які групи тіл додати: 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| label_style | string | необов’язковий | Як підписуються планети: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) або 'symbol' (☉, ☽, ...). englishsanskritsymbol |
| line_color | string | необов’язковий | Колір ліній сітки карти у форматі hex. |
| notation | string | необов’язковий | astrologicaldegree |
| nutation | boolean | необов’язковий | |
| planet_color | string | необов’язковий | Колір підписів планет у форматі hex, напр. '#111827'. За замовчуванням — власний колір теми. |
| rahu | string | необов’язковий | Які вузли додати: 'true' — лише істинні, 'mean' — лише середні, 'both' — обидва типи. truemeanboth |
| refraction | boolean | необов’язковий | |
| render | string | необов’язковий | Передайте 'svg', щоб разом із даними отримати готову діаграму карти (див. chart_style) і геометрію, за якою її побудовано. Якщо параметр не передавати зовсім, відповідь не зміниться. nonesvg |
| show_degrees | boolean | необов’язковий | Показувати біля підпису кожного тіла його градус у знаку. |
| sign_color | string | необов’язковий | Колір номерів і скорочень знаків у форматі hex. |
| svg_size | integer | необов’язковий | Ширина й висота квадратного SVG viewBox у пікселях. min 100 · max 2000 |
| theme | string | необов’язковий | lightdark |
| true_mean | string | необов’язковий | TrueMean |
| use_28_nakshatras | boolean | необов’язковий |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/saptamsa/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'Відповідь
{
"data": {
"planets": [
{
"name": "sun",
"longitude": 220.66583333333335,
"latitude": 0,
"nakshatra": "Anooraadha",
"pada": 3,
"kakshya": "mars",
"zodiac_name": "Scorpio",
"house": 2
},
{
"name": "moon",
"longitude": 10.344444444444443,
"latitude": 4.37,
"nakshatra": "Ashwini",
"pada": 4,
"kakshya": "mars",
"zodiac_name": "Aries",
"house": 7
},
{
"name": "mars",
"longitude": 194.22305555555556,
"latitude": 0.535,
"nakshatra": "Swaati",
"pada": 3,
"kakshya": "sun",
"zodiac_name": "Libra",
"house": 1
},
{
"name": "mercury",
"longitude": 249.55444444444444,
"latitude": 1.574,
"nakshatra": "Moola",
"pada": 3,
"kakshya": "mars",
"zodiac_name": "Sagittarius",
"house": 3
},
{
"name": "jupiter",
"longitude": 46.30361111111111,
"latitude": 0.529,
"nakshatra": "Rohini",
"pada": 2,
"kakshya": "venus",
"zodiac_name": "Taurus",
"house": 8
},
{
"name": "venus",
"longitude": 172.69083333333333,
"latitude": -3.391,
"nakshatra": "Hasta",
"pada": 4,
"kakshya": "moon",
"zodiac_name": "Virgo",
"house": 12
},
{
"name": "saturn",
"longitude": 286.1286111111111,
"latitude": -2.651,
"nakshatra": "Sravanam",
"pada": 2,
"kakshya": "venus",
"zodiac_name": "Capricorn",
"house": 4
},
{
"name": "northtruenode",
"longitude": 338.9608333333333,
"latitude": 0,
"nakshatra": "Uttaraabhaadra",
"pada": 2,
"kakshya": "mars",
"zodiac_name": "Pisces",
"house": 6
},
{
"name": "southtruenode",
"longitude": 158.96083333333334,
"latitude": 0,
"nakshatra": "Uttara Phalguni",
"pada": 4,
"kakshya": "mars",
"zodiac_name": "Virgo",
"house": 12
},
{
"name": "uranus",
"longitude": 289.96722222222223,
"latitude": -0.154,
"nakshatra": "Sravanam",
"pada": 3,
"kakshya": "Mercury",
"zodiac_name": "Capricorn",
"house": 4
},
{
"name": "neptune",
"longitude": 216.02944444444444,
"latitude": -1.412,
"nakshatra": "Anooraadha",
"pada": 1,
"kakshya": "jupiter",
"zodiac_name": "Scorpio",
"house": 2
},
{
"name": "pluto",
"longitude": 154.95222222222225,
"latitude": -4.3,
"nakshatra": "Uttara Phalguni",
"pada": 3,
"kakshya": "jupiter",
"zodiac_name": "Virgo",
"house": 12
}
],
"ascendant": {
"longitude": 205.3144444444445,
"zodiac_name": "Libra",
"nakshatra": "Makha",
"pada": 4
},
"ayanamsa": {
"name": "LAHIRI",
"corrected": false,
"value_degrees": 24.229599,
"formatted": "24°13'47\""
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.