/api/astro/pancha_pakshi_hora/1 кредитПанча-пакши (активность птиц по хорам)
Панча-пакши-шастра — тамильская система: каждому человеку по накшатре рождения и половине месяца назначается одна из пяти птиц (гриф, сова, ворона, петух или павлин), а время суток оценивается по тому, чем эта птица занята. Каждая птица по кругу проходит пять занятий — правление, еда, ходьба, сон и умирание, в порядке убывания благоприятности, — и любая часть дня хороша или плоха в зависимости от того, как занятие вашей птицы соотносится с занятием, действующим в этот момент. Саму птицу возвращает get_birth_bird_from_nakshathra; get_birth_nakshathra и get_paksha возвращают два входных значения, по которым она определяется, — это пригодится, если вы хотите показать ход расчёта. Все три возвращают простые целые числа, а не названия. get_matching_pancha_pakshi_data_from_db возвращает сырую таблицу занятий этой птицы для дня недели и половины месяца запрошенного момента: пятьдесят числовых строк — пять основных периодов дня и пять периодов ночи, каждый разделён на пять подпериодов. В столбцах индексы и доли, а не время по часам: время вы строите сами по восходу и заходу Солнца и коэффициентам продолжительности. Поле запроса nakshatras принимается сериализатором, но этим эндпоинтом не используется.
https://api.occultapi.com/api/astro/pancha_pakshi_hora/Аутентификация
Передавайте ключ в заголовке 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' — разные моменты, и ответы для них будут разными. |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90 |
| 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 |
| nakshatras | string | необязательный | specialМЁРТВЫЙ ПАРАМЕТР на уровне HTTP — PanchaPakshaHoraView передаёт только date_time, geopos и путь к CSV-файлу pancha_pakshi_db. В движке единственное значимое значение — литерал 'special' (подставляет таблицу nakshatras_special из 28 записей. |
Доступные ключи (4)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| get_birth_bird_from_nakshathra | — | Птица рождения одним целым числом от 1 до 5 (1 — гриф, 2 — сова, 3 — ворона, 4 — петух, 5 — павлин). Она определяется по накшатре рождения вместе с половиной месяца, поэтому одна и та же накшатра в двух половинах месяца даёт разных птиц. |
| get_birth_nakshathra | — | Накшатра рождения одним целым числом от 1 до 27 с отсчётом от Ashwini — входное значение для остальных справочных расчётов этого эндпоинта. Возвращается только номер, без названия. |
| get_matching_pancha_pakshi_data_from_db | — | Сырая таблица занятий птицы рождения для дня недели и половины месяца запрошенного момента: пятьдесят строк, каждая — список из четырнадцати чисел, в порядке столбцов: индекс дня недели, индекс пакши, индекс дня/ночи, основная птица, основное занятие, подптица, подзанятие, коэффициент продолжительности, отношение, коэффициент силы, эффект, оценка, паду-пакши, бхарана-пакши. Птицы — 0-4: гриф, сова, ворона, петух, павлин; занятия — 0-4: правление, еда, ходьба, сон, умирание; отношение: 0 — враг, 1 — та же, 2 — друг; эффект — от 0 до 4, от очень плохого до очень хорошего. Строки идут группами по пять — пять основных периодов на каждую половину суток, каждый разделён на пять, — а коэффициент продолжительности задаёт долю каждого подпериода в родительском. Время по часам не включено; стройте его по восходу, заходу Солнца и коэффициентам. |
| get_paksha | — | На какую половину лунного месяца приходится момент — одним целым числом: 1 — шукла (растущая Луна), 2 — кришна (убывающая). В панча-пакши одной и той же накшатре в разных половинах месяца соответствуют разные птицы, так что от этого значения зависит ответ. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/pancha_pakshi_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","keys":["get_birth_bird_from_nakshathra","get_birth_nakshathra","get_matching_pancha_pakshi_data_from_db"],"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"nakshatras":"special"}'Ответ
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_birth_bird_from_nakshathra\": 1, \"get_birth_nakshathra\": 27, \"get_matching_pancha_pakshi_data_from_db\": [[2.0, 1.0, 0.0, 0.0, 2.0, 0.0, 2.0, 0.208333333, 1.0, 0.36, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 3.0, 1.0, 0.208333333, 0.0, 0.48, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 1.0, 4.0, 0.25, 2.0, 0.12, 1.0, 2.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 4.0, 3.0, 0.166666667, 2.0, 0.24, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 2.0, 0.0, 0.166666667, 0.0, 0.6, 2.0, 5.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 0.0, 1.0, 0.208333333, 1.0, 0.64, 3.0, 6.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 3.0, 4.0, 0.25, 0.0, 0.16, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 1.0, 3.0, 0.166666667, 2.0, 0.32, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 4.0, 0.0, 0.166666667, 2.0, 0.8, 4.0, 9.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 2.0, 2.0, 0.208333333, 0.0, 0.48, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 0.0, 4.0, 0.25, 1.0, 0.04, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 3.0, 3.0, 0.166666667, 0.0, 0.08, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 1.0, 0.0, 0.166666667, 2.0, 0.2, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 4.0, 2.0, 0.208333333, 2.0, 0.12, 1.0, 2.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 2.0, 1.0, 0.208333333, 0.0, 0.16, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 0.0, 3.0, 0.166666667, 1.0, 0.16, 1.0, 2.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 3.0, 0.0, 0.166666667, 0.0, 0.4, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 1.0, 2.0, 0.208333333, 2.0, 0.24, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 4.0, 1.0, 0.208333333, 2.0, 0.32, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 2.0, 4.0, 0.25, 0.0, 0.08, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.166666667, 1.0, 1.0, 4.0, 10.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 3.0, 2.0, 0.208333333, 0.0, 0.6, 2.0, 5.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 1.0, 1.0, 0.208333333, 2.0, 0.8, 4.0, 9.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 4.0, 4.0, 0.25, 2.0, 0.2, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 2.0, 3.0, 0.166666667, 0.0, 0.4, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 1.0, 0.0, 1.0, 0.0, 1.0, 0.208333333, 1.0, 0.64, 3.0, 6.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 4.0, 3.0, 0.125, 2.0, 0.32, 2.0, 4.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 3.0, 2.0, 0.25, 0.0, 0.48, 2.0, 4.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 2.0, 4.0, 0.083333333, 2.0, 0.16, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 1.0, 0.0, 0.333333333, 0.0, 0.8, 3.0, 7.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 0.0, 3.0, 0.125, 1.0, 0.16, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 4.0, 2.0, 0.25, 2.0, 0.24, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 3.0, 4.0, 0.083333333, 0.0, 0.08, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 2.0, 0.0, 0.333333333, 2.0, 0.4, 2.0, 5.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 1.0, 1.0, 0.208333333, 0.0, 0.32, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 0.0, 2.0, 0.25, 1.0, 0.36, 2.0, 4.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 4.0, 4.0, 0.083333333, 2.0, 0.12, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 3.0, 0.0, 0.333333333, 0.0, 0.6, 2.0, 5.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 2.0, 1.0, 0.208333333, 2.0, 0.48, 3.0, 6.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 1.0, 3.0, 0.125, 0.0, 0.24, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 0.0, 4.0, 0.083333333, 1.0, 0.04, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 4.0, 0.0, 0.333333333, 2.0, 0.2, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 3.0, 1.0, 0.208333333, 0.0, 0.16, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 2.0, 3.0, 0.125, 2.0, 0.08, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 1.0, 2.0, 0.25, 0.0, 0.12, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.333333333, 1.0, 1.0, 4.0, 10.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 4.0, 1.0, 0.208333333, 2.0, 0.8, 4.0, 9.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 3.0, 3.0, 0.125, 0.0, 0.4, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 2.0, 2.0, 0.25, 2.0, 0.6, 3.0, 7.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 1"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.