POST/api/astro/panchang_element_birth_effect/1 кредит

Влияние панчанги при рождении (справочная таблица)

У каждого элемента панчанги — дня недели, титхи, караны, йоги и половины месяца, а также планетарной хоры — есть классическое толкование характера человека, родившегося под ним. Этот эндпоинт — справочная таблица таких толкований. Это чисто справочный текст: ничего не рассчитывается, и ни дата, ни время, ни место не передаются. Титхи рождения, день недели и прочее вы определяете в другом месте (например, через /api/astro/panchanga/) и передаёте сюда названия, чтобы получить абзац для каждого из них. Шесть справочных ключей — get_vaara_during_birth, get_birth_tithi_effects, get_birth_karana_effects, get_birth_panchang_yoga_effects, get_birth_paksha_effects и get_birth_hora_result; каждый принимает поле запроса с соответствующим названием. Все допустимые значения — транслитерация в нижнем регистре, и написание должно быть точным: 'shula', а не 'shoola', 'priti', а не 'preeti'. Хора называется по санскритскому названию планеты (surya, chandra, mangala…), а не по дню недели. Шесть вспомогательных ключей get_all_*_keys возвращают списки допустимых значений, а get_all_keys_summary — все шесть сразу; берите значения оттуда, а не зашивайте словарь в код. Нераспознанное значение не вызывает ошибку: возвращается HTTP 200 со строкой, в которой перечислены допустимые варианты.

https://api.occultapi.com/api/astro/panchang_element_birth_effect/

Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

Поле	Тип	Обязательно	Примечания
keys	array	обязательный	Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами.
hora	string	необязательный	`suryachandramangalabudhabrihaspatishukrashani` При неизвестном значении возвращается строка "Invalid hora: <x>. Available options: [...]" с HTTP 200, а не статус ошибки; у эндпоинта также есть парный ключ 'get_all_hora_keys', который во время выполнения возвращает именно этот список. Следите за транслитерацией: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (не shoola/preeti/indra), а значения hora — санскритские названия планет (surya/chandra/mangala/budha/brihaspati/shukra/shani), а не английские названия дней недели или планет.
karana	string	необязательный	`bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughna` При неизвестном значении возвращается строка "Invalid karana: <x>. Available options: [...]" с HTTP 200, а не статус ошибки; у эндпоинта также есть парный ключ 'get_all_karana_keys', который во время выполнения возвращает именно этот список. Следите за транслитерацией: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (не shoola/preeti/indra), а значения hora — санскритские названия планет (surya/chandra/mangala/budha/brihaspati/shukra/shani), а не английские названия дней недели или планет.
paksha	string	необязательный	`shuklakrishna` При неизвестном значении возвращается строка "Invalid paksha: <x>. Available options: [...]" с HTTP 200, а не статус ошибки; у эндпоинта также есть парный ключ 'get_all_paksha_keys', который во время выполнения возвращает именно этот список. Следите за транслитерацией: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (не shoola/preeti/indra), а значения hora — санскритские названия планет (surya/chandra/mangala/budha/brihaspati/shukra/shani), а не английские названия дней недели или планет.
tithi	string	необязательный	`pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashi` При неизвестном значении возвращается строка "Invalid tithi: <x>. Available options: [...]" с HTTP 200, а не статус ошибки; у эндпоинта также есть парный ключ 'get_all_tithi_keys', который во время выполнения возвращает именно этот список. Следите за транслитерацией: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (не shoola/preeti/indra), а значения hora — санскритские названия планет (surya/chandra/mangala/budha/brihaspati/shukra/shani), а не английские названия дней недели или планет.
vaara	string	необязательный	`sundaymondaytuesdaywednesdaythursdayfridaysaturday` При неизвестном значении возвращается строка "Invalid vaara: <x>. Available options: [...]" с HTTP 200, а не статус ошибки; у эндпоинта также есть парный ключ 'get_all_vaara_keys', который во время выполнения возвращает именно этот список. Следите за транслитерацией: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (не shoola/preeti/indra), а значения hora — санскритские названия планет (surya/chandra/mangala/budha/brihaspati/shukra/shani), а не английские названия дней недели или планет.
yoga	string	необязательный	`vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruva` При неизвестном значении возвращается строка "Invalid yoga: <x>. Available options: [...]" с HTTP 200, а не статус ошибки; у эндпоинта также есть парный ключ 'get_all_yoga_keys', который во время выполнения возвращает именно этот список. Следите за транслитерацией: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (не shoola/preeti/indra), а значения hora — санскритские названия планет (surya/chandra/mangala/budha/brihaspati/shukra/shani), а не английские названия дней недели или планет.

Доступные ключи (13)

Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.

Ключ	Доп. поля	Описание
get_all_hora_keys	—	Семь названий хор, которые принимает этот эндпоинт, — списком санскритских названий планет в нижнем регистре.
get_all_karana_keys	—	Одиннадцать названий каран, которые принимает этот эндпоинт, — списком строк в нижнем регистре.
get_all_keys_summary	—	Все допустимые значения для всех шести категорий одним объектом с ключами vaara_keys, hora_keys, paksha_keys, tithi_keys, karana_keys и yoga_keys. Один вызов вместо шести.
get_all_paksha_keys	—	Два названия половин месяца, которые принимает этот эндпоинт, — списком строк в нижнем регистре: shukla и krishna.
get_all_tithi_keys	—	Шестнадцать названий титхи, которые принимает этот эндпоинт, — списком строк в нижнем регистре. Используйте его для заполнения списка выбора, а не зашивайте написания в код.
get_all_vaara_keys	—	Семь названий дней недели, которые принимает этот эндпоинт, — списком английских названий дней в нижнем регистре.
get_all_yoga_keys	—	Двадцать семь названий нитья-йог, которые принимает этот эндпоинт, — списком строк в нижнем регистре.
get_birth_hora_result	hora	Толкование для планетарной хоры, управляющей моментом рождения. Принимает hora как санскритское название планеты в нижнем регистре — surya, chandra, mangala, budha, brihaspati, shukra, shani — и возвращает короткий абзац текста на английском языке.
get_birth_karana_effects	karana	Толкование для караны рождения. Принимает karana как одно из одиннадцати названий в нижнем регистре (bava, balava, kaulava, taitila, gara, vanija, vishti, shakuni, chatushpada, naga, kimstughna) и возвращает абзац текста на английском языке.
get_birth_paksha_effects	paksha	Толкование рождения в светлую или тёмную половину месяца. Принимает paksha как 'shukla' или 'krishna' и возвращает абзац текста на английском языке.
get_birth_panchang_yoga_effects	yoga	Толкование для нитья-йоги, действующей при рождении. Принимает yoga как одно из двадцати семи названий в нижнем регистре, от vishkumbha до vaidhriti, и возвращает абзац текста на английском языке.
get_birth_tithi_effects	tithi	Толкование для титхи рождения. Принимает tithi как одно из шестнадцати названий в нижнем регистре — от pratipada до chaturdashi, а также purnima и amavasya — и возвращает абзац текста на английском языке. Одно название относится к этой титхи в любой половине месяца.
get_vaara_during_birth	vaara	Толкование характера человека, родившегося в заданный день недели. Принимает vaara как английское название дня в нижнем регистре и возвращает абзац текста на английском языке. На нераспознанное значение возвращается строка со списком допустимых вариантов — тоже с HTTP 200.

Пример запроса

curl -X POST https://api.occultapi.com/api/astro/panchang_element_birth_effect/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_vaara_during_birth"],"vaara":"sunday","hora":"surya","paksha":"shukla","tithi":"pratipada","karana":"bava","yoga":"vishkumbha"}'

Ответ

{
  "data": {
    "get_vaara_during_birth": "Individuals born on Sunday typically possess a steady and determined nature with a fearless approach to life. They often have a naturally authoritative disposition and demonstrate skillfulness in their endeavors. These individuals tend to be honorable and maintain high standards of purity in their conduct. They may have a tendency toward bilious temperament and often exhibit leadership qualities with a noble bearing."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.