Назад к документации

Panchang

Panchang

POST/api/v2/vedic/panchang

Рассчитайте V2 sunrise-based ежедневно Panchang для даты, времени и местоположения, включая Титхи, Nakshatra, Йогу, Карану и Rahu Калам.

Аутентификация: отправьте x-api-key.

Полный URL-адрес

https://api.freeastroapi.com/api/v2/vedic/panchang
Безопасные повторы с Idempotency-Key

Аутентифицированные платные astrology POST-запросы принимают необязательный заголовок Idempotency-Key: <уникальный ключ операции, созданный клиентом>. Повторно используйте тот же ключ только при повторе точно того же method, path, query string и JSON body после timeout или сетевой ошибки.

Завершенный повтор возвращает первый ответ с Idempotency-Replayed: true, не запускает расчет заново и не расходует дополнительную квоту. Ключи хранятся примерно 24 часа.

Повторное использование ключа с измененным запросом возвращает 409 idempotency_key_reused. Дубликат, пока первый запрос еще выполняется, возвращает 409 request_in_progress с Retry-After.

Что он возвращает

Полезная нагрузка ежедневного альманаха с восходом, закатом, днем ​​недели, лунным месяцем, основными элементами Panchang, временем перехода, значениями Rahu Kalam, request-time Panchang и метаданными вычислений.

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

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/panchang" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "year": 1997,
  "month": 9,
  "day": 22,
  "hour": 23,
  "minute": 25,
  "city": "Mumbai",
  "lat": 19.391928,
  "lng": 72.839732,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean"
}'

Параметры запроса

Передайте city либо оба поля — lat и lng. Для стабильных результатов в production рекомендуется использовать координаты.

Field
year
Type
integer
Required
Yes
Description
Год рождения.
Field
month
Type
integer
Required
Yes
Description
Месяц рождения (1-12).
Field
day
Type
integer
Required
Yes
Description
День рождения.
Field
hour
Type
integer
Required
Yes
Description
Час рождения (0-23).
Field
minute
Type
integer
Required
Yes
Description
Минута рождения (0-59).
Field
city
Type
string
Required
No
Description
Город рождения. Необязательно, если имеется lat/lng.
Field
lat
Type
float
Required
No
Description
Широта рождения. Рекомендуется для production-использования.
Field
lng
Type
float
Required
No
Description
Долгота рождения. Рекомендуется для production-использования.
Field
tz_str
Type
string
Required
No
Description
Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено.
Field
ayanamsha
Type
string
Required
No
Description
Ведическая айанамша. По умолчанию — lahiri.
Field
house_system
Type
string
Required
No
Description
Система домов. По умолчанию — whole_sign.
Field
node_type
Type
string
Required
No
Description
Тип лунного узла: mean или true.

Форма ответа

Field
date
Type
string
Required
n/a
Description
Запрошена местная дата.
Field
sunrise / sunset
Type
string
Required
n/a
Description
Локальное время sunrise и sunset.
Field
weekday
Type
object
Required
n/a
Description
Номер и название дня недели.
Field
lunar_month
Type
object
Required
n/a
Description
Название лунного месяца, флаг Amanta и год Vikram Samvat.
Field
tithi / nakshatra / yoga / karanas
Type
object
Required
n/a
Description
Основные элементы Panchang со временем перехода.
Field
rahu_kalam
Type
object
Required
n/a
Description
Ежедневные Раху Калам начинаются и заканчиваются.
Field
request_time_panchang
Type
object
Required
n/a
Description
Значения Panchang активны в запрошенное местное время.
Field
metadata
Type
object
Required
n/a
Description
Версия конечной точки, набор правил, айанамша, часовой пояс и основа расчета.

Пример реального запроса

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

{
  "year": 1997,
  "month": 9,
  "day": 22,
  "hour": 23,
  "minute": 25,
  "city": "Mumbai",
  "lat": 19.391928,
  "lng": 72.839732,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean"
}

Пример реального ответа

Это реальный производственный ответ на пример полезной нагрузки. Большие массивы намеренно отображаются так, как их возвращает API.

V2
{
  "date": "1997-09-22",
  "location": {
    "lat": 19.391928,
    "lng": 72.839732
  },
  "sunrise": "06:27:14",
  "sunset": "18:35:15",
  "weekday": {
    "number": 2,
    "name": "Monday"
  },
  "lunar_month": {
    "name": "Bhadrapada",
    "amanta": true,
    "vikram_samvat": 2054
  },
  "tithi": {
    "number": 21,
    "name": "Shashti",
    "ends_at": "07:38:58",
    "ends_at_iso": "1997-09-22T07:38:58.096672+05:30",
    "paksha": "Krishna"
  },
  "nakshatra": {
    "number": 4,
    "name": "Rohini",
    "ends_at": "18:29:18",
    "ends_at_iso": "1997-09-22T18:29:18.330247+05:30",
    "pada": 2,
    "lord": "Moon"
  },
  "yoga": {
    "number": 16,
    "name": "Siddhi",
    "ends_at": "25:42:19",
    "ends_at_iso": "1997-09-23T01:42:19.175767+05:30"
  },
  "karanas": [
    {
      "number": 6,
      "name": "Vanij",
      "ends_at": "07:38:58",
      "ends_at_iso": "1997-09-22T07:38:58.096672+05:30"
    },
    {
      "number": 7,
      "name": "Vishti",
      "ends_at": "19:15:41",
      "ends_at_iso": "1997-09-22T19:15:41.241485+05:30"
    },
    {
      "number": 1,
      "name": "Bhav",
      "ends_at": "31:04:25",
      "ends_at_iso": "1997-09-23T07:04:25.830624+05:30"
    }
  ],
  "rahu_kalam": {
    "start": "07:58",
    "end": "09:29"
  },
  "request_time_panchang": {
    "tithi": {
      "number": 22,
      "name": "Saptami",
      "paksha": "Krishna"
    },
    "nakshatra": {
      "number": 5,
      "name": "Mrigashirsha",
      "pada": 1,
      "lord": "Mars"
    },
    "yoga": {
      "number": 16,
      "name": "Siddhi"
    },
    "karana": {
      "number": 1,
      "name": "Bhav"
    },
    "sun_sign": {
      "sign_id": 6,
      "name": "Virgo",
      "degree": 5.9305
    },
    "moon_sign": {
      "sign_id": 2,
      "name": "Taurus",
      "degree": 26.0527
    }
  },
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "astrosage_panchang_v1",
    "ayanamsha": "lahiri",
    "timezone_used": "Asia/Kolkata",
    "calculation_basis": "sunrise_day_with_transition_times",
    "request_local_time": "1997-09-22T23:25:00+05:30"
  }
}

Связанные документы

Полный ведический расчетОсновная ведическая карта