/api/astro/kp-chart/1 кредитКарта KP (куспіди, знаки та планети)
Карта Крішнамурті Паддхаті (KP), розкладена на окремі частини з назвами, а не одним непрозорим блоком. KP — окрема традиція з широким колом прихильників, і досі всю карту можна було отримати, лише якщо ви вже знали п’ять назв ключів, які треба запитати. Цей ендпоінт повертає асцендент, дванадцять куспідів домів із їхніми початком, серединою та кінцем, знак на кожному куспіді, довготу кожної планети та дім, у який вона потрапляє. KP використовує куспіди Плацидуса на сидеричному зодіаку, тому для того самого народження розміщення в домах відрізняється від /api/astro/chart/. Так і має працювати ця система; це не розбіжність між двома ендпоінтами.
https://api.occultapi.com/api/astro/kp-chart/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| date_time | string (date-time) | обов’язковий | Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC, і може повернути результат за попередній день із кодом 200. '2026-09-01T06:00:00Z' і '2026-09-01 06:00:00' — різні моменти, і відповіді для них різні. |
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -89.9 · max 89.9 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
| keys | array | необов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. |
| new_start | integer | необов’язковий | Початок коригування куспідів, передається в ядро без змін. |
| notation | string | необов’язковий |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/kp-chart/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-05-10T19:55:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"notation":"degree","new_start":50}'Відповідь
{
"data": {
"system": "krishnamurti_paddhati",
"ascendant": 216.7733892763535,
"houses": [
{
"house": 1,
"sign": "Sc",
"start": 216.7733892763535,
"middle": 231.85829168898027,
"end": 246.94319410160705
},
{
"house": 2,
"sign": "Sg",
"start": 246.94319410160705,
"middle": 263.38929149306404,
"end": 279.835388884521
},
{
"house": 3,
"sign": "Cp",
"start": 279.835388884521,
"middle": 296.8815490763593,
"end": 313.92770926819765
},
{
"house": 4,
"sign": "Aq",
"start": 313.92770926819765,
"middle": 329.81303441531793,
"end": 345.69835956243827
},
{
"house": 5,
"sign": "Pi",
"start": 345.69835956243827,
"middle": 179.37096263847687,
"end": 13.043565714515491
},
{
"house": 6,
"sign": "Ar",
"start": 13.043565714515491,
"middle": 24.90847749543448,
"end": 36.77338927635347
},
{
"house": 7,
"sign": "Ta",
"start": 36.77338927635347,
"middle": 51.858291688980245,
"end": 66.94319410160702
},
{
"house": 8,
"sign": "Ge",
"start": 66.94319410160702,
"middle": 83.38929149306404,
"end": 99.83538888452104
},
{
"house": 9,
"sign": "Cn",
"start": 99.83538888452104,
"middle": 116.88154907635936,
"end": 133.92770926819765
},
{
"house": 10,
"sign": "Le",
"start": 133.92770926819765,
"middle": 149.813034415318,
"end": 165.6983595624383
},
{
"house": 11,
"sign": "Vi",
"start": 165.6983595624383,
"middle": 179.3709626384769,
"end": 193.04356571451547
},
{
"house": 12,
"sign": "Li",
"start": 193.04356571451547,
"middle": 204.90847749543448,
"end": 216.7733892763535
}
],
"planet_longitudes": {
"sun": 25.059,
"moon": 213.651,
"mercury": 14.844,
"venus": 342.642,
"mars": 320.082,
"jupiter": 74.022,
"saturn": 270.704,
"uranus": 254.688,
"neptune": 259.811,
"pluto": 201.695,
"northtruenode": 286.265,
"northmeannode": 286.99,
"southtruenode": 106.265,
"southmeannode": 106.99
},
"planet_houses": {
"sun": 6,
"moon": 12,
"mercury": 6,
"venus": 4,
"mars": 4,
"jupiter": 8,
"saturn": 2,
"uranus": 2,
"neptune": 2,
"pluto": 12,
"northtruenode": 3,
"northmeannode": 3,
"southtruenode": 9,
"southmeannode": 9
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.