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

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 and lng. Координаты рекомендуются для стабильных результатов производства.

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"
  }
}

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

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