Перейти к основному содержимому

Журнал изменений

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

Один расчёт — один эндпоинт: одиннадцать дублей выведены из работы

Некоторые расчёты были доступны дважды — обычно через старый эндпоинт, принимавший внутренние ключи движка, и через новый, который возвращает те же результаты с понятными названиями. Старые копии выведены из работы, и теперь у каждого расчёта один эндпоинт. Ничего не потеряно: все результаты каждого выведенного эндпоинта доступны в эндпоинте, который его заменяет.

Мудда-даша

Мудда-даша теперь написана правильно и находится по адресу /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, без кода. Плагин отправлен в официальный каталог плагинов и ждёт проверки.

Что изменилось

Четырнадцать блоков: панчанга, Раху-калам, чогхадия, Абхиджит- и Брахма-мухурта, дурмухурта, даты экадаши, амавасьи, пурнимы, прадоши и санкашти-чатуртхи, календарь праздников, рашифал и форма кундли. Каждый — настоящий блок редактора, который перетаскивается из панели вставки, как любой стандартный блок, и у каждого есть парный шорткод для тех, кто всё ещё работает в Classic Editor.

Почему это важно

Владелец сайта, ни разу не написавший ни строчки на 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 сфер, и состав выборки зависит от даты, — поэтому страница вроде «Овен: здоровье» не могла существовать: в некоторые дни здоровья в выборке не было. Шесть новых эндпоинтов возвращают ВСЕ сферы при каждом вызове: 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 под вашим брендом — полный гороскоп и годовую книгу на двенадцать месяцев. А ещё — кала-сарпа, каракамша, чакра Сарватобхадра и два маршрута Лал Китаб.

Готовые PDF-отчёты — 2 новых

Тело ответа — ЭТО И ЕСТЬ PDF. Второго запроса нет, файл нигде не размещается: мы ничего не храним, поэтому и ссылки, которую мог бы найти кто-то другой, нет. Не вызывайте для них .json() — записывайте байты на диск (curl -o report.pdf, res.arrayBuffer(), response.content). Гороскоп занимает около 27 страниц со сгенерированным оглавлением. Годовая книга делит следующие двенадцать месяцев по пратьянтардашам вимшоттари, а не по календарным месяцам, так что её разделы начинаются и заканчиваются в даты, которые задаёт ваша карта. Оба принимают необязательный блок брендинга — название компании, контакты и logo_url (по этой ссылке мы загружаем логотип и размещаем его на обложке), — так что ваш клиент видит ваше имя, а не наше. Оба детерминированы: одни и те же данные рождения дают один и тот же документ. Обычное время — меньше двух секунд.

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

Кала-сарпа и каракамша — 2 новых

Кала-сарпа возвращает не просто «да» или «нет», а то, какие грахи оказались по какую сторону оси Раху — Кету. Большинство карт не кала-сарпа, и два списка показывают, не хватило ли карте одной грахи или четырёх. Название формы (Ананта, Кулика, Васуки…) заполняется, только когда йога действительно образуется. СТОИТ ЗНАТЬ: /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/

Песочница умеет отдавать файл

Если эндпоинт отвечает файлом, песочница теперь показывает его имя, тип и размер с кнопкой «Скачать», а не пытается вывести байты как текст. Страница справочника для таких эндпоинтов тоже больше не предлагает распаковать и разобрать ответ: эта формулировка относилась к маршрутам со сжатым 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) chart» и «Krishnamurti paddhati» теперь называются «Карта KP (куспиды, знаки и планеты)» и «Части KP (выбор через keys)»: первый отдаёт всю карту, во втором вы сами называете нужные части. «House lord placements» и «House lord placement», различавшиеся одной буквой, стали «Положения управителей домов (все 144)» и «Положение управителя дома (одна пара)». Два эндпоинта, которые оба назывались «Pancha Pakshi», теперь «Панча-пакши (активность птиц по хорам)» и «Панча-пакши (день из десяти ям)». «Birth panchanga effects» и «Birth panchanga readings» стали «Влияние панчанга при рождении (справочная таблица)» и «Толкования панчанга рождения (ваши элементы)».

Маршруты не изменились

Это только отображаемые названия в документации. Все маршруты, поля запросов и ответов остались в точности прежними — в интеграции ничего менять не нужно. Если вы сохранили страницу документации в закладках, адрес по-прежнему работает; понятнее стал только заголовок вверху.

Скриншоты на страницах справочника

На 43 страницах эндпоинтов теперь есть скриншот данных этого эндпоинта в работающем интерфейсе: панчанга, чогхадия, календарь праздников, ретроградные периоды, одиннадцать региональных календарей, натальные карты и другое. Таблица полей показывает структуру ответа, но не то, для чего он нужен, а одного взгляда на картинку обычно хватает, чтобы понять, тот ли это эндпоинт. На главной странице документации и на главной странице сайта — тот же набор.

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

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

Задайте render: "svg" в существующем эндпоинте карты — и получите готовую схему карты в североиндийском или южноиндийском стиле, а также геометрию, на которой она построена, для тех, кто делает собственную отрисовку.

Что изменилось

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

Почему это важно

Построить круг карты из сырых долгот — серьёзная работа: геометрия домов, поворот знаков, размещение подписей. И каждый интегратор делал её с нуля. Теперь это одно поле в вызове, который вы и так делаете. Геометрия разметки пригодится тем, кто рисует нативно в React, Canvas, Flutter или SwiftUI, а не использует нашу разметку.

Существующее не изменилось

По умолчанию render равно "none", а каждое другое новое поле по умолчанию имеет значение, которое ничего не делает. Запрос, в котором ни одно из них не упомянуто, получает ответ, побайтно идентичный прежнему, — это проверено до выпуска на всех типах карт и параметрах, которые принимает этот эндпоинт.

Смотреть /api/astro/chart/
  • эндпоинты
  • карта
  • svg

42 новых эндпоинта: именованные даши, традиционная западная астрология, китайская Ба-цзы и таро

Тридцать систем даш, которые раньше были доступны только через строковый параметр, получили собственные названия и маршруты, а четыре традиции, которых не было вовсе, теперь поддерживаются. Ничего из того, что уже работало, не изменилось.

Даши, которые можно найти поиском

Мы и раньше считали тридцать систем даш — одиннадцать накшатровых и девятнадцать раши-даш, каждую на несколько уровней вложенности, — но они были значениями строки 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
  • инструменты

Песочница в браузере

Запустите любой эндпоинт прямо из документации со своим ключом и посмотрите на реальный ответ — ещё до того, как напишете хоть строчку кода.

Что изменилось

Страница каждого эндпоинта ведёт прямо в песочницу с уже заполненным примером запроса. Поменяйте широту, дату или аянамшу и отправьте снова.

Почему это важно

Пример ответа показывает структуру данных. А собственные входные данные показывают, отвечает ли API на ваш вопрос.

Открыть песочницу
  • песочница

Occult API запущен

Расчёты ведической астрологии через REST API, с API-ключами и кредитами за каждый вызов.

Что изменилось

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

Почему это важно

Не нужно разбираться в прайс-листе по эндпоинтам. Расчёты выполняются по эфемеридам NASA JPL с полным набором классических и современных аянамш.

Получить API-ключ
  • запуск
  • оплата