Перейти до вмісту

Журнал змін

Нові ендпоінти, документація й зміни платформи, від найновіших. Наявні ендпоінти ніколи не змінюються у вас за спиною: якщо поведінку довелося б змінити, поруч зі старим ендпоінтом з’являється новий.

Один розрахунок — один ендпоінт: одинадцять дублікатів вилучено

Деякі розрахунки були доступні двічі: зазвичай як старий ендпоінт, що приймав сирі ключі рушія, і новий, який повертає ті самі результати з назвами. Старі копії вилучено, тож тепер у кожного розрахунку один ендпоінт. Нічого не втрачено: усі результати вилученого ендпоінта повертає ендпоінт, який його замінив.

Мудда-даша

Мудда-даша тепер написана правильно й живе за адресою /api/astro/mudda-dasha/, поруч із мунтхою в розділі «Таджика й варшапхал». Старий /api/astro/muddha_dasha/ вилучено. Новий ендпоінт повертає володарів за назвами, а кожен початок — як часову позначку ISO, а не номери планет і рядок дати зі словником градусів усередині.

  • POST /api/astro/mudda-dasha/

Що чим замінено

Аспекти таджики: /api/astro/tajika/aspects/ замість /api/astro/tajaka/. Йоги таджики: /api/astro/tajika/yogas/ замість /api/astro/tajaka_yoga/. Сахами: /api/astro/sahams/ замість /api/astro/saham/. Прашнавалі: чотири ендпоінти /api/astro/prashnavali/ замість /api/astro/chakra/. Гун-мілан: /api/astro/ashtakoota/ з ключем `compatibility_score`, який повертає ті самі тринадцять значень (вісім балів за кутами, загальний бал із 36 і чотири південноіндійські перевірки), замість /api/astro/gun-milan/. Шадбала: /api/astro/strength/ замість /api/astro/shadbala/. Накшатрові й раші-даші: /api/astro/dasha/nakshatra/ і /api/astro/dasha/rashi/ замість /api/nakshatra_dasha/ і /api/raasi_dasha/. Затемнення: сім окремих ендпоінтів /api/astro/eclipse/ замість сирого /api/astro/eclipse/. KP: /api/astro/kp-chart/ замість /api/astro/krishnamurti/.

Якщо ви викликаєте вилучений ендпоінт

Виклик будь-якого з них з API-ключем тепер повертає 403 endpoint_not_allowed, і кредит не списується. Перейдіть на заміну з переліку вище — SDK і колекція Postman уже її використовують.

  • POST /api/astro/muddha_dasha/
  • POST /api/astro/tajaka/
  • POST /api/astro/tajaka_yoga/
  • POST /api/astro/saham/
  • POST /api/astro/chakra/
  • POST /api/astro/gun-milan/
  • POST /api/astro/shadbala/
  • POST /api/nakshatra_dasha/
  • POST /api/raasi_dasha/
  • POST /api/astro/eclipse/
  • POST /api/astro/krishnamurti/
  • ендпоінти
  • вилучено
  • таджика

Ендпоінти з даними народження знаменитостей прибрано

Два ендпоінти зі знаменитостями з Astro Data більше не входять до API. Їх прибрано з документації, колекції Postman і SDK, а виклики до них з API-ключем тепер відхиляються.

Що змінилося

Списку знаменитостей і пошуку окремої знаменитості більше немає. Виклик будь-якого з цих ендпоінтів з API-ключем повертає 403 endpoint_not_allowed, і кредит не списується. Усі інші ендпоінти не змінилися. Якщо ви зберегли дані народження з цих ендпоінтів, їх і далі можна надсилати до ендпоінтів карт, як будь-які інші дані народження.

  • GET /api/astro-data/celebrities/
  • GET /api/astro-data/celebrities/{id}/
  • ендпоінти
  • вилучено

Дві нові системи прашни: Джамакол і Аштамангала

Дві хорарні карти, яких API досі не рахував: тамільський Джамакол і керальська Аштамангала з «Прашна-марги». Кожен виклик — один кредит, як і на будь-якому іншому ендпоінті.

Джамакол-прашна

Надішліть місцевий час, коли поставлено запитання, разом із місцем і його зміщенням від UTC. У відповідь ви отримаєте вісім джама-грах, Удхаям, Арудам і Кавіппу, джамам дня чи ночі, Кулігана, Емакандам, Мрітью і час Раху, планети й панчанг на цей момент. Передайте arudam_sign, якщо знак обирає сам запитувач; якщо поле не передати, Арудам визначається за годинником. Звірено з jamakkol.com на понад 20 картах; щоб результат точно збігався з цим сайтом, надсилайте ayanamsa true_citra із середнім вузлом.

  • POST /api/astro/prashna/jamakkol/

Аштамангала-прашна

Надішліть момент і місце, знак Арудхи, який обрав запитувач, і каурі — трьома купками або тризначним числом. У відповідь ви отримаєте Арудху, Чатру, шість раші Прашна-крії з органом, яким керує кожна, п’ять сутр, планети від Лагни й від Арудхи та повне тлумачення числа, цифра за цифрою. Сфут тут немає: щоб їх отримати, викличте /api/astro/prashna/ для того самого моменту.

  • POST /api/astro/prashna/ashtamangala/
  • ендпоінти
  • прашна

Ендпоінти панчанга: у запиті лишилися тільки ті поля, які кожен справді читає

29 вузьких ендпоінтів панчанга — day-night-length, samvat, lunar-month, upagraha, tithi, nakshatra і ще 23 — більше не описують і не приймають полів для гуліки, манді, епохи самватсари й налаштування аномалії, яких їхній розрахунок ніколи не читав. Змінювати те, як ви сьогодні викликаєте ці ендпоінти, не треба.

Що змінилося

Усі ці ендпоінти мають спільний серіалізатор запиту з /api/astro/panchanga/ — єдиним ендпоінтом, який справді рахує всі п’ятдесят із лишком ключів панчанга й потребує кожного вхідного параметра, що їх ці ключі разом використовують. Вузькі ендпоінти успадкували весь цей перелік полів без розбору. Тож /day-night-length/, де лише арифметика сходу й заходу Сонця, описував і приймав gulika_rises_at, gulika_portion, mandi_rises_at, mandi_portion, kala_mrityu_rise_at і dhuma_vyatipata_relation (налаштування тіньових точок), samvata_type і mode (перемикачі епохи й способу лічби), а також mean_anomaly, eccentricity, eccentric_anomaly, tolerance і nakshatras — тринадцять полів, жодного з яких його розрахунок не читає. Тепер кожен ендпоінт описує й приймає лише ті поля, які справді використовує: /samvat/ зберігає samvata_type, /lunar-month/ — mode, /upagraha/ — шість полів gulika/mandi/kala-mrityu/dhuma-vyatipata, а решта 26 не зберігають жодного з тринадцяти.

  • POST /api/astro/panchang/
  • POST /api/astro/rahu-kaal/
  • POST /api/astro/choghadiya/
  • POST /api/astro/hora/
  • POST /api/astro/auspicious-timings/
  • POST /api/astro/inauspicious-timings/
  • POST /api/astro/vasa-segments/
  • POST /api/astro/lunar-phase/
  • POST /api/astro/day-night-length/
  • POST /api/astro/sankranti/
  • POST /api/astro/tithi/
  • POST /api/astro/nakshatra/
  • POST /api/astro/nitya-yoga/
  • POST /api/astro/karana/
  • POST /api/astro/abhijit-muhurat/
  • POST /api/astro/brahma-muhurat/
  • POST /api/astro/amrit-kaal/
  • POST /api/astro/durmuhurat/
  • POST /api/astro/disha-shool/
  • POST /api/astro/muhurta-table/
  • POST /api/astro/sandhya/
  • POST /api/astro/panchak/
  • POST /api/astro/samvat/
  • POST /api/astro/lunar-month/
  • POST /api/astro/tarabala/
  • POST /api/astro/chandrabala/
  • POST /api/astro/lagna/
  • POST /api/astro/bhava-cusps/
  • POST /api/astro/upagraha/

Чому це важливо

Поле на сторінці ендпоінта в довіднику — це обіцянка, що воно на щось впливає. А тут не впливало: gulika_rises_at, надісланий до /day-night-length/, завжди мовчки ігнорувався. Це гірше, ніж якби поля не було взагалі, — воно спокушає витрачати час на налаштування, яке ніколи не змінить відповіді. Тепер на сторінці кожного ендпоінта перелічено саме ті параметри, що впливають на його результат, і нічого більше.

Нічого не зламається

Розрахунки цих ендпоінтів ніколи не читали цих полів, тож прибрати їх із документації й схеми — означає не змінити поведінку жодного ендпоінта. Якщо ваша інтеграція вже надсилає одне з них, скажімо, до /day-night-length/, запит і далі успішний, а відповідь та сама. Перед випуском ми перевірили це парними викликами «до» і «після» на кожному зачепленому ендпоінті. Єдина різниця: сторінка в довіднику й згенеровані типи SDK більше не пропонують налаштування, яке ніколи нічого не робило.

Відкрити /api/astro/day-night-length/
  • ендпоінти
  • документація
  • панчанг

Плагін для WordPress

Панчанг, час мухурт, дати врат і свят, форма натальної карти й блоки гороскопів — чотирнадцять нативних блоків WordPress, без жодного коду. Плагін подано до офіційного каталогу, він чекає на перевірку.

Що змінилося

Чотирнадцять блоків: панчанг, раху кала, чогхадія, абхіджит- і брахма-мухурта, дурмухурта, дати екадаші/амавасьї/пурніми/прадоша/санкашті-чатуртхі, календар свят, рашифал і форма кундлі. Кожен — повноцінний блок редактора: його перетягують із панелі вставлення, як будь-який стандартний блок. Для тих, хто досі працює в класичному редакторі, кожен блок має й відповідний шорткод.

Чому це важливо

Власник сайту, який ніколи не писав PHP, може додати на сайт живий віджет панчанга за той час, що потрібен, щоб перетягнути блок і вставити API-ключ. Плагін — лише тонкий шар відображення над тими самими ендпоінтами, про які йдеться в цьому журналі змін. Власної логіки розрахунків у нього немає, тож розійтися з API він не може.

Отримати плагін для WordPress
  • wordpress
  • інструменти

Серія дробових карт, від D1 до D144

П’ятнадцять нових ендпоінтів доповнюють серію варг. Тепер у кожного поділу, який рахує рушій, є власний маршрут, а не лише значення chart_name, про яке ніхто не здогадується.

Тепер маршрут є в усіх шістнадцяти шодашаварг — 8 нових

D1 раші, D4 чатуртхамша, D16 шодашамша, D20 вімшамша, D24 чатурвімшамша, D27 накшатрамша, D40 кхаведамша і D45 акшаведамша приєдналися до восьми вже опублікованих (D2, D3, D7, D9, D10, D12, D30, D60). НІЧОГО НОВОГО НЕ РАХУЄТЬСЯ: /api/astro/chart/ завжди міг видати ці карти через chart_name, а нові маршрути передають роботу тому самому обробнику, тож числа збігаються за самою побудовою. Змінилося те, що їх тепер можна знайти: маршрут /navamsa/ видно одразу, а chart_name, захований у тілі запиту, — ні. /api/astro/rashi/ — той самий обробник із зафіксованою картою, і його відповідь побайтово збігається з /api/astro/planet-positions/. Це перевіряє тест, тож вони не можуть розійтися.

  • POST /api/astro/rashi/
  • POST /api/astro/chaturthamsa/
  • POST /api/astro/shodasamsa/
  • POST /api/astro/vimsamsa/
  • POST /api/astro/chaturvimsamsa/
  • POST /api/astro/nakshatramsa/
  • POST /api/astro/khavedamsa/
  • POST /api/astro/akshavedamsa/

Чотири поділи поза шодашаваргою — 4 нові

D5 панчамша (слава й влада), D6 шаштхамша (здоров’я й вороги), D8 аштамша (довголіття й раптові події) і D11 рудрамша (здобутки). Їх використовують поряд із класичними шістнадцятьма, а не як їхню частину, і кожна відповідь про це каже. ВАРТО ЗНАТИ про D11: дві традиції читають її протилежно — одна як здобутки, як підказує одинадцятий дім, інша як Рудру, а отже, руйнування. Ми не вибираємо за вас.

  • POST /api/astro/panchamsa/
  • POST /api/astro/shashthamsa/
  • POST /api/astro/ashtamsa/
  • POST /api/astro/rudramsa/

Після D60 — 3 нові

D81 навнавамша, D108 астоттарамша і D144 двадашдвадашамша. ЦЕ СКЛАДЕНІ ПОДІЛИ, і рушій знає два прочитання кожного: прямий поділ раші на 81, 108 чи 144 частини — і варгу від варги. Ці маршрути віддають СКЛАДЕНИЙ варіант, бо саме його буквально означає кожна назва: нава-навамша — це навамша навамші, двадаш-двадашамша — двадашамша двадашамші. Прямий поділ і далі доступний через /api/astro/chart/ як NavnavamsaChart, AstottaramsaChart і DwadasdwadasamsaChart, і для більшості планет він дає інший знак — це різні карти, а не два написання однієї. Тест перевіряє, що вони справді різні, тож випадково скасувати цей вибір не вийде. Коли на поділ припадає 22, 17 і 12 кутових хвилин, ці карти варто читати лише тоді, коли час народження справді відомий з точністю до хвилини. Інакше вони показують хіба що округлення у вашому свідоцтві про народження.

  • POST /api/astro/navnavamsa/
  • POST /api/astro/astottaramsa/
  • POST /api/astro/dwadasdwadasamsa/

Тепер у документації вони йдуть за номером поділу

Довідник сортував кожну групу за алфавітом, тож D10 стояла перед D2, а D144 — перед D16. Через цю плутанину серія здавалася неповною, навіть коли такою не була: читач, який шукав D20, не знав, де її шукати. Тепер дробові карти скрізь сортуються за номером поділу.

Те, що вже було, не змінилося

Усі п’ятнадцять — нові маршрути, які фіксують chart_name, а решту роботи передають обробнику, що вже обслуговує /api/astro/planet-positions/. /api/astro/chart/ і далі приймає всі значення chart_name, що й раніше, зокрема альтернативні способи розрахунку без власного маршруту — ParivrittidwayaHora, SomnathDrekkana, JagannathDrekkana та інші. Вони лишаються де були: це варіанти поділу, який уже має маршрут, і шукає їх той, хто знає потрібну назву.

  • ендпоінти
  • дробові карти
  • варга

Рашифал за періодами, дев’ять систем нумерології і ще три маршрути Лал Кітаб

Дев’ятнадцять нових ендпоінтів: рашифал за періодами й сферами життя, дев’ять нумерологічних традицій на додачу до чотирьох наявних і маршрути Лал Кітаб для домів, планет і вигляду карти.

Рашифал за періодами й сферами — 6 нових

/api/astro/rashifal/ повертає змінну добірку з 3–4 сфер, і які саме — залежить від дати. Тож сторінки «Овен: здоров’я» бути не могло: у деякі дні health просто не потрапляв у добірку. Нові шість ендпоінтів щоразу повертають УСІ сфери: general, career_business, love_relationships, money_finances, health, education_student, family, travel і ще дві, яких базовий рушій ніколи не мав, — business і professionals. Передайте aspect, щоб отримати лише одну: саме це потрібно сторінці окремої сфери. Тексти детерміновані: той самий знак, період, сфера й дата завжди дають ті самі слова, тож сторінку можна кешувати, і після оновлення вона не суперечитиме сама собі. Тижневий додає найкращі й складні дні, місячний — транзити, особливі дні й ремедії, річний — прогноз на квартали й щасливі елементи. rashi і aspect не залежать від регістру, як і в наявному ендпоінті.

  • POST /api/astro/rashifal/daily/
  • POST /api/astro/rashifal/tomorrow/
  • POST /api/astro/rashifal/yesterday/
  • POST /api/astro/rashifal/weekly/
  • POST /api/astro/rashifal/monthly/
  • POST /api/astro/rashifal/yearly/

Дев’ять систем нумерології — 10 нових

Каббала відображає ім’я на 22 стежки Дерева, кожну з її літерою івриту й старшим арканом таро. Гематрія рахує текст на івриті за п’ятьма шифрами (standard, gadol, ordinal, katan, atbash). Таро дає карти народження, партнера й імені; І Цзін — гексаграми народження й імені в порядку Вень-вана (64); Сефаріал — його власну таблицю 1920 року з планетами-володарями; Хейро — халдейську таблицю, прочитану до складеного числа. Абджад та ісопсефія рахують арабський і грецький текст, разом із застарілими літерами-цифрами — дигамою, копою, сампі. ТРИ З НИХ ПРАЦЮЮТЬ ЛИШЕ З ОДНИМ ПИСЬМОМ: абджад — з арабським, ісопсефія — з грецьким, гематрія — з івритом. Якщо надіслати текст іншим письмом, вони повернуть 0 і перелічать кожен символ в unscored, а не транслітеруватимуть: кожне джерело транслітерує по-своєму, а впевнене число з довільного вибору гірше за очевидний нуль.

  • POST /api/astro/numerology/kabbalah/
  • POST /api/astro/numerology/gematria/
  • POST /api/astro/numerology/tarot/
  • POST /api/astro/numerology/iching/
  • POST /api/astro/numerology/sepharial/
  • POST /api/astro/numerology/abjad/
  • POST /api/astro/numerology/isopsephy/
  • POST /api/astro/numerology/angel/
  • POST /api/astro/numerology/aura/
  • POST /api/astro/numerology/cheiro/

Доми, планети й вигляд карти Лал Кітаб — 3 нові

Та сама традиція фіксованих домів, що й у двох маршрутах, доданих учора, — у трьох формах, з яких сторінку справді будують. /horoscope/ — це карта як дванадцять комірок-знаків із градусом кожної планети в її знаку. /houses/ показує для кожного дому його володаря, грахи, для яких це пакка-гхар, і хто там в екзальтації чи в падінні. pakka_ghar — це СПИСОК, бо Меркурій і Венера ділять 7-й дім, Марс і Сатурн — 8-й, а Юпітер і Раху — 12-й, і одне значення загубило б одного з них. /planets/ показує гідність і природу кожної грахи. Природа Місяця й Меркурія не фіксована, а розраховується: у Місяця — за пакшею, у Меркурія — за тим, чи стоїть у його знаку природний малефік. У кожному рядку є nature_basis з правилом, за яким це визначено. ВАРТО ЗНАТИ: position для Раху й Кету дорівнює null, якщо вони не в екзальтації й не в падінні. Вони не керують жодним знаком, тож «знак друга» нема з чим порівнювати.

  • POST /api/astro/lal-kitab/horoscope/
  • POST /api/astro/lal-kitab/houses/
  • POST /api/astro/lal-kitab/planets/

На що ми й далі не відповідаємо

Борги Лал Кітаб (рін) і даша Лал Кітаб відсутні навмисно, як і поля soya та kismat, які інші постачальники повертають у своєму ендпоінті домів. Назви восьми боргів у всіх джерелах однакові, а умови, за яких виникає кожен, — ні: навіть опубліковані правила для одного лише пітра-рін розходяться так, що для тієї самої карти дають різні відповіді. Те саме з soya. Ми краще не повернемо нічого, ніж опублікуємо вердикт про чиїхось предків навмання, тому цих полів немає, а відповідь пояснює чому.

Те, що вже було, не змінилося

Усі дев’ятнадцять — нові маршрути. /api/astro/rashifal/ і далі приймає те саме тіло й повертає ту саму змінну добірку. Дев’ять нових систем нумерології — окремий модуль, а не нові значення в /api/astro/numerology/, тож наявні поля system і keys не змінилися. Хейро використовує вже наявні в API халдейську таблицю літер і значення складених чисел, а не дублює їх.

  • ендпоінти
  • рашифал
  • нумерологія
  • лал кітаб

PDF-звіти й п’ять нових ендпоінтів розрахунків

Два ендпоінти, які повертають не JSON, а готовий PDF під вашим брендом (white-label), — повний гороскоп і річник на дванадцять місяців. А ще кала-сарпа, каракамша, чакра Сарватобхадра й два маршрути Лал Кітаб.

Готові PDF-звіти — 2 нові

Тіло відповіді — ЦЕ І Є PDF. Другого запиту немає, файлу на сервері теж: ми нічого не зберігаємо, тож і посилання, яке міг би знайти хтось інший, немає. Не викликайте для цих відповідей .json() — записуйте байти на диск (curl -o report.pdf, res.arrayBuffer(), response.content). Гороскоп — близько 27 сторінок зі згенерованим змістом. Річник ділить наступні дванадцять місяців за пратьянтардашами вімшоттарі, а не за календарними місяцями, тож його розділи починаються й закінчуються в дати, які задає ваша карта. Обидва звіти приймають необов’язковий блок branding — назву компанії, контакти й logo_url, за яким ми завантажуємо логотип і ставимо його на обкладинку, — щоб ваш клієнт бачив вашу назву, а не нашу. Обидва детерміновані: ті самі дані народження дають той самий документ. Зазвичай генерація триває менше двох секунд.

  • POST /api/astro/pdf/horoscope/ · 25 кредитів
  • POST /api/astro/pdf/yearbook/ · 25 кредитів

Кала-сарпа й каракамша — 2 нові

Кала-сарпа повертає не просто «так» чи «ні», а які грахи по який бік осі Раху — Кету. Більшість карт не мають кала-сарпи, і два списки показують, чого забракло: однієї грахи чи чотирьох. Назва форми (Anant, Kulik, Vasuki …) заповнюється лише тоді, коли йога справді утворилася. ВАРТО ЗНАТИ: /api/astro/karakamsa/ упорядковує чара-караки за градусом У МЕЖАХ знака й для більшості карт назве іншого атмакараку, ніж /api/astro/chara-karakas/. Їх рахують по-різному, і вони не взаємозамінні; для роботи з каракамшею беріть новий ендпоінт.

  • POST /api/astro/kalsarp/
  • POST /api/astro/karakamsa/

Чакра Сарватобхадра — 1 нова

Транзитна дошка дев’ять на дев’ять. Разом із розташуваннями повертається вся сітка, тож її можна намалювати, а не лише прочитати з неї вердикт: для кожної клітинки вказано, що в ній, її затінення й чотири склади пад її накшатри. Передайте transit_date_time, щоб поставити транзитні грахи на ту саму дошку; тоді hits_natal перелічить ті, чия ведха падає на накшатру, зайняту у вашій натальній карті. Застосовується лише позиційна ведха, і поле rule каже про це в кожній відповіді: школи тут розходяться, а відповідь без такої позначки не перевіриш. Якщо написання накшатри ми не впізнали, вона не зникає, а повертається в unplaced.

  • POST /api/astro/sarvatobhadra/

Лал Кітаб — 2 нові

Це окрема північноіндійська традиція, і перше, що треба знати: У ЛАЛ КІТАБ ДОМИ ЗАКРІПЛЕНІ ЗА ЗНАКАМИ. 1-й дім — завжди Овен, і так далі до 12-го, який завжди Риби, у будь-якій карті. Дім планети — це номер її знака, тож майже в усіх результати БУДУТЬ розходитися з /api/astro/chart/ і /api/astro/planet-positions/. Це особливість системи, а не помилка. Для кожної грахи повертається її пакка-гхар і чи стоїть вона в ньому. Варшпхал тут арифметичний, а не астрономічний: кожна планета зсувається на один дім за кожен повний рік життя, тож що дванадцятий рік річна карта повертається до натального розташування.

  • POST /api/astro/lal-kitab/chart/
  • POST /api/astro/lal-kitab/varshphal/

Playground тепер віддає файл

Якщо ендпоінт відповідає файлом, Playground тепер показує його назву, тип і розмір із кнопкою Download, а не намагається вивести байти як текст. І сторінка таких ендпоінтів у довіднику більше не радить розпакувати й розібрати відповідь: ця порада стосувалася маршрутів зі стиснутим gzip JSON і для PDF була хибною.

Те, що вже було, не змінилося

П’ять ендпоінтів розрахунків — це нові маршрути, які передають роботу обробникам, що вже обслуговують /api/astro/planet-positions/ і дробові карти, тож числа збігаються за самою побудовою. PDF-звіти збираються внутрішніми викликами тих самих ендпоінтів: положення на сторінці 3 — рівно те, що повертає /api/astro/planet-positions/. Увесь звіт оплачується як один виклик, а не як двадцять п’ять, з яких його зібрано.

  • ендпоінти
  • pdf
  • звіти
  • чакри
  • лал кітаб

24 нові ендпоінти: 23 маршрути даш і астрологічний чат

Двадцять дві системи даш, які рушій рахував завжди, отримали власні ендпоінти. А ще — деталізація, що повертає одну гілку дерева даш замість усього дерева, і ендпоінт чату, який простою мовою відповідає на запитання про карту.

Умовні накшатрові даші — 7 нових

Планетні: кожен володар у відповіді — граха. Усі сім — УМОВНІ: класичні тексти застосовують їх лише тоді, коли карта відповідає певній умові. Тож перш ніж пропонувати якусь із них для тлумачення, перевірте /api/astro/dasha_applicability/.

  • POST /api/astro/dasha/dwadashottari/
  • POST /api/astro/dasha/panchottari/
  • POST /api/astro/dasha/sataabdika/
  • POST /api/astro/dasha/chaturaseeti-sama/
  • POST /api/astro/dasha/dwisaptati/
  • POST /api/astro/dasha/shattrimsa-sama/
  • POST /api/astro/dasha/budhi-gati/

Раші-даші Джайміні — 15 нових

Знакові: тут кожен володар — раші, а не планета. Саме на цю різницю варто зважати: поле lord означає тут зовсім інше, ніж у накшатрових дашах вище, і якщо прочитати його не так, результат неможливо буде витлумачити.

  • POST /api/astro/dasha/drig/
  • POST /api/astro/dasha/nirayana-shoola/
  • POST /api/astro/dasha/shoola/
  • POST /api/astro/dasha/sthira/
  • POST /api/astro/dasha/trikona/
  • POST /api/astro/dasha/brahma/
  • POST /api/astro/dasha/chakra/
  • POST /api/astro/dasha/kendradhi/
  • POST /api/astro/dasha/lagnamsaka/
  • POST /api/astro/dasha/mandooka/
  • POST /api/astro/dasha/navamsa/
  • POST /api/astro/dasha/paryaaya/
  • POST /api/astro/dasha/sandhya/
  • POST /api/astro/dasha/tara-lagna/
  • POST /api/astro/dasha/yogardha/

Одна гілка замість усього дерева — 1 новий

levels обмежує, наскільки ГЛИБОКО заходить відповідь даші, але на цій глибині все одно повертає всі періоди: levels=3 для вімшоттарі — це кожна пратьянтардаша в кожній антардаші кожної махадаші, за нашими вимірами 95 КБ. Надішліть {"lords": ["moon", "mars"], "levels": 1} — і отримаєте лише періоди всередині однієї цієї антардаші, близько 1,8 КБ. Це економить передавання й розбір, а не обчислення.

  • POST /api/astro/dasha/drill/

Астрологічний чат — 1 новий

Надішліть дані народження й запитання — і отримаєте відповідь звичайним текстом разом із класичними уривками, на які вона спирається, кожен із посиланням та оцінкою, тож міркування можна перевірити. Дані народження беруться з ВАШОГО запиту, а не з акаунта, тож питати можна від імені будь-кого з ваших користувачів. Для запитань про сумісність додайте compare_with, а в history можна передати до двадцяти попередніх реплік. Між викликами нічого не зберігається. Виклик коштує 25 кредитів, а не 1, бо кожну відповідь генерує мовна модель на основі розрахованої карти; невдала чи порожня відповідь нічого не коштує.

  • POST /api/astro/chat/ · 25 кредитів

Тридцять систем даш, тепер згруповані

Тепер окремий ендпоінт мають тридцять систем, а не вісім. До решти можна було дістатися лише рядком, переданим у /api/nakshatra_dasha/ чи /api/raasi_dasha/, тож пошук «narayana dasha» нічого не знаходив. У довіднику їх тепер поділено на три групи — накшатрові (планетні), раші (Джайміні) та інструменти — замість одного алфавітного списку з тридцяти п’яти, де брахма-даша стояла поруч із будхі-гаті-дашею.

Те, що вже було, не змінилося

/api/nakshatra_dasha/ і /api/raasi_dasha/ не змінилися, а вісім наявних ендпоінтів даш працюють точно так само, як і раніше. Кожен новий маршрут передає роботу тому самому батьківському обробнику, тож числа збігаються за самою побудовою, а не завдяки копії, яка могла б розійтися. Ендпоінт чату не пов’язаний із наявними маршрутами застосунку /api/ai/, і ті не змінилися.

Як працювати з колекцією Postman
  • ендпоінти
  • даші
  • ШІ

Чотири ендпоінти прашнавалі й нова категорія «Аватар-чакра»

Рам Шалака, Хануман, Саї й Мавджі Махарадж отримали по власному ендпоінту, а не ховаються за масивом keys в /api/astro/chakra/. Фільтр за номером тепер необов’язковий, а записи повертаються впорядкованим списком.

Що нового

POST /api/astro/prashnavali/ram-shalaka/ повертає 225 чаупаї Рам Шалака Прашнавалі: для кожної — літеру деванагарі, саму чаупаї, місце в «Рамачарітаманасі» й відповідь англійською. /api/astro/prashnavali/hanuman/ повертає 49 пронумерованих відповідей, /api/astro/prashnavali/sai/ — 720 відповідей Саї, а /api/astro/prashnavali/mavji/ — 64 тлумачення Мавджі Махараджа гінді й англійською. Усі чотири зібрано в довіднику в новій категорії «Аватар-чакра».

Три речі, яких не вміє батьківський ендпоінт

Фільтр скрізь необов’язковий. /api/astro/chakra/ відхиляє запит sai_prashnavali без номера, а ці ендпоінти просто повертають увесь набір — саме так зазвичай і працюють із даними оракулів: отримати раз, закешувати, проіндексувати в себе. Записи повертаються СПИСКОМ з індексом у кожному записі, а не об’єктом із ключами-числами у вигляді рядків. Тож їх можна перебирати по порядку, не сортуючи рядкові ключі як числа (інакше вийде 1, 10, 100, 11). А ще кожна відповідь містить count, тож запит одного запису можна відрізнити від повного набору, не розбираючи вміст.

Те, що вже було, не змінилося

/api/astro/chakra/ не змінився. Він і далі віддає всі чотири набори даних через поле keys, і далі повертає ту саму структуру {key: data}, і далі відповідає 400 на sai_prashnavali без номера. Якщо ви вже з ним інтегровані, вас це не зачіпає: це додаткові маршрути, а не заміна.

  • ендпоінти
  • прашнавалі
  • оракули

Зрозуміліші назви ендпоінтів і знімки реальних результатів у довіднику

У чотирьох пар ендпоінтів назви не підказували, який із двох вам потрібен: одна пара називалася однаково, інша відрізнялася однією літерою. Ми їх перейменували. Окрім того, на 43 сторінках ендпоінтів тепер є зображення того, що ендпоінт справді повертає.

Що перейменовано в довіднику

«Карта KP (Krishnamurti)» і «Крішнамурті-паддхаті» тепер називаються «Карта KP (куспіди, знаки й планети)» і «Частини KP (вибір через keys)»: перший ендпоінт віддає всю карту, а в другому ви самі називаєте потрібні частини. «House lord placements» і «House lord placement», що відрізнялися однією літерою, тепер мають уточнення «(усі 144)» і «(одна пара)». Два ендпоінти, які обидва називалися «Панча-пакші», тепер уточнено як «(активність птахів за хорами)» і «(день у десяти ямах)». «Впливи панчанга народження» й «Тлумачення панчанга народження» тепер мають уточнення «(довідкова таблиця)» і «(ваші елементи)».

Маршрути не змінилися

Це лише назви в документації. Усі маршрути, поля запиту й поля відповіді лишилися точно такими, як були, — в інтеграції нічого оновлювати не треба. Якщо сторінку документації збережено в закладках, URL-адреса й далі працює; просто заголовок угорі став зрозумілішим.

Знімки екрана на сторінках довідника

На 43 сторінках ендпоінтів тепер є знімок екрана з даними цього ендпоінта в робочому інтерфейсі: панчанг, чогхадія, календар свят, ретроградні періоди, одинадцять регіональних календарів, натальні карти тощо. Таблиця полів показує структуру відповіді, але не те, навіщо вона, а один погляд на знімок зазвичай одразу підказує, чи це потрібний вам ендпоінт. Той самий набір є на головній сторінці документації й на головній сторінці сайту.

  • документація
  • назви

Схеми карт: SVG і геометрія розмітки в /api/astro/chart/

Задайте render: "svg" у наявному ендпоінті карт — і отримаєте готову схему карти в північно- чи південноіндійському стилі, а також її геометрію для тих, хто малює карту сам.

Що змінилося

/api/astro/chart/ тепер приймає необов’язкове поле render. Якщо його не передавати, нічого не зміниться — відповідь буде точно такою, як завжди. Якщо задати "svg", до звичних чотирьох полів додадуться ще два: layout (точки багатокутника кожної клітинки дому чи знака, місце підпису й які планети в ній стоять) і svg (готова розмітка, яку можна одразу вставити на сторінку). chart_style вибирає північноіндійський стиль (ромб, доми на місці, знаки обертаються) або південноіндійський (сітка знаків на місці, обертаються доми); svg_size, theme, label_style, show_degrees і чотири поля *_color відповідають за вигляд.

Чому це важливо

Намалювати карту із сирих довгот — це чимала робота: геометрія домів, обертання знаків, розміщення підписів. І кожен, хто інтегрував API, робив її з нуля. Тепер це одне поле у виклику, який ви й так робите. А геометрія з layout стане в пригоді тим, хто малює карту нативно в React, Canvas, Flutter чи SwiftUI, а не бере нашу розмітку.

Те, що вже було, не змінилося

За замовчуванням render дорівнює "none", а кожне інше нове поле за замовчуванням має значення, яке ні на що не впливає. Запит, у якому жодне з них не згадано, отримує відповідь, побайтово ідентичну тій, що була до цього оновлення, — ми перевірили це для всіх типів карт і параметрів, які приймає ендпоінт.

Відкрити /api/astro/chart/
  • ендпоінти
  • карта
  • svg

42 нові ендпоінти: даші з власними назвами, традиційна західна астрологія, китайська BaZi й таро

Тридцять систем даш, до яких раніше можна було дістатися лише через рядковий параметр, отримали власні назви й маршрути. А чотири традиції, яких ми зовсім не мали, тепер є. Усе, що вже працювало, не змінилося.

Даші, які можна знайти пошуком

Ми й раніше рахували тридцять систем даш — одинадцять накшатрових і дев’ятнадцять раші-даш, кожну на кілька рівнів вкладеності. Але це були лише значення рядка dasha_type у двох ендпоінтах — nakshatra_dasha і raasi_dasha, тож пошук «vimshottari dasha» нічого не знаходив. Тепер є маршрути з назвами: /api/astro/dasha/vimshottari/, /yogini/, /ashtottari/, /chara/, /narayana/, /kalachakra/ та інші, а також /api/astro/dasha/systems/ з переліком усіх систем і ендпоінтів для кожної. Два початкові ендпоінти не змінилися й працюють далі.

Яка даша триває зараз

/api/astro/dasha/current/ відповідає на запитання, на яке ендпоінти часових шкал відповісти не могли: він повертає ланцюжок від махадаші вниз — «Юпітер / Кету / Меркурій» — з початком і кінцем кожного рівня, тим, скільки з нього вже минуло, і скількома днями, що лишилися. Раніше для цього доводилося отримувати все дерево, рекурсивно обходити його й порівнювати дати у власному коді.

Традиційна й елліністична західна астрологія

/api/astro/traditional/dignities/ повертає обитель, екзальтацію, трипліцитет, терм і фас для кожної планети з балом за Ліллі; /almuten/ — планету з найбільшою гідністю для кожної точки карти; /sect/ — чи карта денна, чи нічна, і що з цього випливає; /profections/ — річну, місячну й денну профекцію з володарем року. Усі вони тропічні, як того вимагає доктрина, а у відповіді вказано, які таблиці термів і трипліцитетів використано: джерела розходяться, а бал за іншою таблицею — це вже інше число.

Похідні карти й Місяць

Драконічна, гармонічна, антисційна, геліоцентрична карти й карта Девісона в /api/astro/western/, а також /api/astro/lunar/void-of-course/ і /api/astro/lunar/mansions/. Місяць без курсу — це пошук уперед, а не миттєвий знімок: ендпоінт проходить час до того, як Місяць змінить знак, повідомляє про кожен аспект, що стане точним, і коли саме, а також коли період без курсу починається й закінчується.

Китайські «Чотири стовпи»

/api/astro/chinese/four-pillars/, /bazi/, /zodiac/ і /luck-pillars/. Китайський рік починається з Лічунь, близько 4 лютого, — не 1 січня й не в Китайський Новий рік: той припадає на місячну дату й визначає свято, а не карту. Для народження 20 січня 2024 року ви отримаєте Водяного Кролика, а не Дерев’яного Дракона. І межа доби, і істинний сонячний час задаються полями запиту, бо практики тут розходяться, а кожен варіант змінює карту.

Таро

/api/astro/tarot/draw/, /spread/, /yes-no/ і /deck/. Кожне витягування повертає seed, з якого воно вийшло, і якщо надіслати цей seed знову, витягування повториться точно: ті самі карти, той самий порядок, те саме положення. Тож розклад можна зберегти й показати знову, а не давати людині іншу відповідь на те саме запитання. Шість розкладів із назвами, аж до десятикарткового Кельтського хреста, кожна позиція підписана.

А ще

/api/astro/eclipse/visibility-path/ показує, де сонячне затемнення буде повним, у вигляді координат, які можна нанести на мапу, разом із точкою найбільшої фази й серією сарос. Ще дев’ять ендпоінтів виносять в окремі маршрути розрахунки, для яких раніше треба було знати, які ключі запитати в більшого ендпоінта: прастара й содхана аштакаварги, аспекти й йоги таджики, горизонтальні й екваторіальні координати планет, освітленість Місяця, сегменти васа й казімі.

Те, що вже було, не змінилося

Кожен ендпоінт тут — новий маршрут. У жодному наявному ендпоінті не змінилися ні тіло запиту, ні структура відповіді, ні назви полів, і жоден ендпоінт не прибрано й не перейменовано. Ціни ті самі: успішний виклик коштує один кредит, хоч би що він повертав.

Переглянути ендпоінти
  • ендпоінти
  • даша
  • західна
  • китайська
  • таро

117 вузьких ендпоінтів

Будь-який елемент панчанга, дробову карту чи розрахунок сили тепер можна викликати окремо, а не лише в складі більшої відповіді.

Що змінилося

Ендпоінти на кшталт /api/astro/sunrise/, /api/astro/tithi/, /api/astro/navamsa/ і /api/astro/rahu-kaal/ приймають звичні поля народження чи дати й повертають лише те, що вказано в назві. Наявні комбіновані ендпоінти не змінилися й працюють точно так, як і раніше.

Чому це важливо

Щоб показати час сходу Сонця, більше не треба запитувати, оплачувати й розбирати повну відповідь панчанга. Менше даних, менше коду для перетворення і тіло запиту, яке легко прочитати.

Як почати

Відкрийте довідник і надішліть приклад запиту зі своїм ключем у заголовку X-API-Key. Ціни ті самі: успішний виклик коштує один кредит, хоч би що він повертав.

Переглянути ендпоінти
  • ендпоінти
  • панчанг
  • карти

MCP-сервер

Викликайте API з Claude чи будь-якого іншого MCP-клієнта, не пишучи наперед жодної інтеграції.

Що змінилося

MCP-сервер occult-api надає пошук ендпоінтів, їхні описи й виклики як інструменти. Дайте йому свій API-ключ — і асистент сам знайде потрібний ендпоінт і викличе його.

Чому це важливо

Це найшвидший спосіб випробувати API на реальному запитанні, перш ніж щось будувати. А заодно — робочий зразок того, як правильно формувати запити.

Налаштувати MCP-сервер
  • mcp
  • інструменти

Playground у браузері

Запустіть будь-який ендпоінт із документації зі своїм ключем і подивіться на справжню відповідь — ще до першого рядка коду.

Що змінилося

Сторінка кожного ендпоінта веде прямо в Playground, де приклад запиту вже заповнено. Змініть широту, дату чи аянамшу й надішліть запит знову.

Чому це важливо

Приклад відповіді показує, як виглядають дані. А ваші власні вхідні дані покажуть, чи відповідає API на ваше запитання.

Відкрити Playground
  • playground

Occult API запущено

Розрахунки з ведичної астрології через REST API — з API-ключами й кредитами, що списуються за кожен виклик.

Що змінилося

Зареєструйтеся, створіть ключ і надсилайте його в заголовку X-API-Key. Кредити списуються за кожен успішний виклик — за невдалий запит не платите ніколи.

Чому це важливо

Не треба розбиратися в окремих цінах для кожного ендпоінта. Розрахунки ведуться за ефемеридами NASA JPL з повним набором класичних і сучасних аянамш.

Отримати API-ключ
  • запуск
  • оплата