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

Йоги панчанги

Йога панчанги — добра чи погана якість цілого дня, що має власну назву й виникає з поєднання місячного дня (тітхі), дня тижня (вара) і місячної стоянки (накшатра). Найвідоміші — Sarvartha Siddhi («усі цілі вдаються»), Amrit Siddhi, Tripushkara, Dagdha, Mrityu і Yamaghanta. У практиці мухурти це перший фільтр: обирають день зі сприятливим поєднанням і уникають дня з несприятливим. Це сканування по днях. Воно проходить кожен календарний день запитаного року, один раз оцінює йоги на момент сходу Сонця цього дня і повертає лише дні, на які припадає хоча б одна йога. Відповідь — `data.days`, список `{date, yogas}`, де `date` має формат `YYYY-MM-DD`, а `yogas` — список назв; дні без жодної йоги у відповідь не потрапляють. Більшість назв містить у дужках конвенцію-джерело, напр. "Amrit Yoga (Vaara Tithi Yoga)" або "Padma Yoga (Vashishta Samhita Yogas)", бо кілька класичних текстів визначають набори, що перекриваються. Йоги визначаються на момент сходу Сонця, тож latitude, longitude і `timezone_as_float` впливають на результат. `use_28_nakshatras` за замовчуванням true і додає Абхіджит як повноцінну накшатру; деякі йоги, як-от понеділкова Kaana Yoga, визначено через Абхіджит, і без нього вони з’явитися не можуть. Щоб використати звичайний список із 27 накшатр, встановіть false. Цей ендпоінт не пов’язаний з `/api/astro/yogas/`, який знаходить поєднання планет у натальній карті; натальна карта тут ніде не розглядається. Для Ravi Yoga є окремий `/api/astro/ravi_yoga/`: він дає точний час початку й кінця, а не позначку на день.

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

Спробувати запит

Результат «Йоги панчанги» в інтерфейсі — Дані цього ендпоінта в живому інтерфейсі. API повертає значення, а вигляд сторінки ви будуєте самі.

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

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

Поля запиту

Поле	Тип	Обов’язкове	Примітки
latitude	number (double)	обов’язковий	Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси.
longitude	number (double)	обов’язковий	Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї.
timezone_as_float	number (double)	обов’язковий	Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення.
year	integer	обов’язковий	Рік народження числом, напр. 1990. Чотири цифри. min 1800 · max 2400
use_28_nakshatras	boolean	необов’язковий

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/panchanga_yogas/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'

Відповідь

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"days\": [{\"date\": \"2026-01-01\", \"yogas\": [\"utpaata\", \"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Utpaata/Pravas (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-02\", \"yogas\": [\"Ravi Yoga (Sun and Moon Nakshatra)\", \"Upagraha Dosha\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Padma Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-03\", \"yogas\": [\"Mrityu (Vaara Tithi Yoga)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-05\", \"yogas\": [\"sarvartha_siddhi\", \"Always bestows welfare (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Sarvarth-Siddha Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Maha Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-06\", \"yogas\": [\"sarvartha_siddhi\", \"Dhumra Vashishta Samhita Yoga (Malefic)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-09\", \"yogas\": [\"Ravi Yoga (Sun and Moon Nakshatra)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Padma Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-10\", \"yogas\": [\"mrityu\", \"yama_ghanta\", \"Mrityu/Maran (Vaara Nakshatra Malefic/Bad Yoga)\", \"Yamaghanta (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Vimardan Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-11\", \"yogas\": [\"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Saumya Yog (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-12\", \"yogas\": [\"Auspicious for all types of works (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Maha Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-13\", \"yogas\": [\"Din Mrityu Yoga\", \"Halahalopam Yogas (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-14\", \"yogas\": [\"amrit_siddhi\"]}, {\"date\": \"2026-01-16\", \"yogas\": [\"Upagraha Dosha\", \"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Sarvarth-Siddha Yoga (Vaara Nakshatra Auspicious/Good Yogas)\"]}, {\"date\": \"2026-01-17\", \"yogas\": [\"Din Mrityu Yoga\", \"Upagraha Dosha\", \"Prashasta Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\"]}, {\"date\": \"2026-01-18\", \"yogas\": [\"Amrit Yoga (Vaara Tithi Yoga)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-19\", \"yogas\": [\"kaana\", \"Ratnakur Yoga (Vaara Tithi Yoga)\", \"Kaana/Vyadhi (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-20\", \"yogas\": [\"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-21\", \"yogas\": [\"dagdha_nakshatra\", \"panchaka\", \"Auspicious for Manglik works (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Tithi-Nakshatra-Vaara combination Malefic/Bad Yogas\", \"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Mrityu (Vaara Tithi Yoga)\", \"Dagdha (Vashishta's opinion) (Vaara Tithi Yoga)\", \"Dagdha (Brihaspati's opinion) (Vaara Tithi Yoga)\", \"Dagdha (Vaara Nakshatra Malefic/Bad Yoga)\", \"Vish Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-22\", \"yogas\": [\"panchaka\", \"Tithi-Nakshatra-Vaara combination Malefic/Bad Yogas\", \"Mrityu (Vaara Tithi Yoga)\", \"Dagdha (Brihaspati's opinion) (Vaara Tithi Yoga)\", \"Vish Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Amrit Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-23\", \"yogas\": [\"panchaka\", \"Ratnaku"
}

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

Помилки

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