POST/api/panchpakshi/1 кредит

Панча-пакши (сутки из десяти ям)

Панча-пакши — южноиндийская система выбора времени: каждому человеку соответствует одна из пяти птиц — гриф, сова, ворона, петух или павлин, — а сутки делятся на десять периодов, ям: пять между восходом и заходом Солнца и пять между заходом и следующим восходом. В полной традиции за эти периоды каждая птица проходит пять состояний активности (правит, ест, ходит, спит и умирает), и дела планируют на периоды, когда ваша птица сильна. Эндпоинт возвращает две основы этой схемы: границы ям для заданного дня и места и птицу рождения для заданного момента. `datetime`, `latitude`, `longitude` и `timezone_as_float` задают день и место. `fixed` задаёт способ деления суток: при false используются реальные местные восход и заход Солнца, поэтому дневные и ночные ямы разной длины и в течение года смещаются; при true день фиксирован — с 06:00 до 18:00, что даёт десять равных периодов по 2 часа 24 минуты; именно так считают традиционные таблицы. Ответ — `{yamas, birth panchpakshi}`. `yamas` содержит `daytime` и `nighttime` — для каждого список из пяти местных меток времени `{start, end}` в формате 'YYYY-MM-DD HH:MM:SS'. `birth panchpakshi` — одна строка: Vulture, Owl, Crow, Cock или Peacock. Птица определяется по группе накшатры Луны в этот момент и по пакше: одна и та же группа накшатр даёт разных птиц в растущую и убывающую половины месяца, кроме средней группы — она в обеих даёт Crow.

https://api.occultapi.com/api/panchpakshi/

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

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

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

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

Поля запроса

Поле	Тип	Обязательно	Примечания
datetime	string (date-time)	обязательный	Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC. То же, что date_time: другие эндпоинты называют это поле иначе.
fixed	boolean	обязательный
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: PanchpakshiView вызывает только get_birth_panchpakshi(date_time=... В движке осмысленно только значение 'special': оно выбирает таблицу nakshatras_special из 28 записей вместо стандартной таблицы из 27.

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

curl -X POST https://api.occultapi.com/api/panchpakshi/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fixed":true,"datetime":"2024-11-21T09:39:20.910Z","latitude":26.1046,"longitude":74.319,"timezone_as_float":5.5}'

Ответ

{
  "data": {
    "yamas": {
      "daytime": [
        {
          "start": "2024-11-21 06:00:00",
          "end": "2024-11-21 08:24:00"
        },
        {
          "start": "2024-11-21 08:24:00",
          "end": "2024-11-21 10:48:00"
        },
        {
          "start": "2024-11-21 10:48:00",
          "end": "2024-11-21 13:12:00"
        },
        {
          "start": "2024-11-21 13:12:00",
          "end": "2024-11-21 15:36:00"
        },
        {
          "start": "2024-11-21 15:36:00",
          "end": "2024-11-21 18:00:00"
        }
      ],
      "nighttime": [
        {
          "start": "2024-11-21 18:00:00",
          "end": "2024-11-21 20:24:00"
        },
        {
          "start": "2024-11-21 20:24:00",
          "end": "2024-11-21 22:48:00"
        },
        {
          "start": "2024-11-21 22:48:00",
          "end": "2024-11-22 01:12:00"
        },
        {
          "start": "2024-11-22 01:12:00",
          "end": "2024-11-22 03:36:00"
        },
        {
          "start": "2024-11-22 03:36:00",
          "end": "2024-11-22 06:00:00"
        }
      ]
    },
    "birth panchpakshi": "Cock"
  },
  "message": "successful",
  "is_error": false
}

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

Ошибки

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