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

Поиск ведических ежедневных мухуратов

Поиск ведических ежедневных мухуратов

POST/api/v2/vedic/qa

Найдите поддерживаемые ежедневные темы Ведического Мухурата со структурированными периодами, полными таблицами дня и ночи, поиском текущего периода и доказательствами расчета Panchang.

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

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

https://api.freeastroapi.com/api/v2/vedic/qa
Безопасные повторы с 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.

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

Полезные данные структурированного поиска с обнаруженным намерением, ответом human-readable, основным периодом, если применимо, current_period для предоставленного местного времени, сгруппированными разделами таблицы, плоскими периодами, контекстом Panchang, предупреждениями и метаданными вычислений.

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

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/qa" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "question": "chaughadia",
  "date": "2026-04-30",
  "time": "10:30",
  "city": "New Delhi",
  "lat": 28.62137,
  "lng": 77.2148,
  "ayanamsha": "lahiri",
  "language": "en"
}'

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

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

Поле
question
Тип
string
Обязательно
Да
Описание
Поддерживается ежедневная тематическая фраза Muhurat, переносимая в существующее поле вопроса. Официальные темы: абхиджит мухурат, rahu каал, брахма мухурат, до гхати мухурат, хора, чаугхадия, гоури панчангам, панчак и бхадра.
Поле
date
Тип
string
Обязательно
Нет
Описание
Целевая локальная дата: YYYY-MM-DD. По умолчанию для решенного местоположения используется сегодняшний день.
Поле
time
Тип
string
Обязательно
Нет
Описание
Дополнительное локальное время поиска как HH:MM или HH:MM:SS. Используется для заполнения current_period, когда это применимо.
Поле
city
Тип
string
Обязательно
Нет
Описание
Название локации. Необязательно, если имеется lat/lng.
Поле
lat
Тип
float
Обязательно
Нет
Описание
Широта. Рекомендуется для стабильных производственных результатов.
Поле
lng
Тип
float
Обязательно
Нет
Описание
Долгота. Рекомендуется для стабильных производственных результатов.
Поле
tz_str
Тип
string
Обязательно
Нет
Описание
Необязательное переопределение часового пояса, например Asia/Kolkata, Europe/London, AUTO или LMT. По умолчанию используется AUTO, если опущено.
Поле
ayanamsha
Тип
string
Обязательно
Нет
Описание
Ведическая айанамша. По умолчанию — lahiri.
Поле
language
Тип
string
Обязательно
Нет
Описание
Язык ответа. В настоящее время поддерживается только en.

Форма ответа

Поле
intent
Тип
string
Обязательно
Не применимо
Описание
Обнаружено ведическое намерение QA, такое как чаугхадия, хора, панчак или бхадра.
Поле
question
Тип
string
Обязательно
Не применимо
Описание
Поддерживаемая тематическая фраза, отправленная клиентом.
Поле
answer
Тип
string
Обязательно
Не применимо
Описание
Короткий понятный человеку ответ.
Поле
date
Тип
string
Обязательно
Не применимо
Описание
Разрешенная местная дата, используемая для расчета.
Поле
location
Тип
object
Обязательно
Не применимо
Описание
Разрешенные широта и долгота.
Поле
period
Тип
object
Обязательно
Не применимо
Описание
Основной период для ответов в одном окне, например Rahu Kaal или Brahma Muhurat.
Поле
current_period
Тип
object
Обязательно
Не применимо
Описание
Период, активный в переданное или текущее локальное время, если доступен.
Поле
sections
Тип
object
Обязательно
Не применимо
Описание
Сгруппированные полные разделы таблицы, например дневные, ночные или еженедельные.
Поле
periods
Тип
array
Обязательно
Не применимо
Описание
Плоский список всех возвращенных периодов.
Поле
panchang_context
Тип
object
Обязательно
Не применимо
Описание
Контекст sunrise, sunset, дня недели и Rahu Kalam, используемый в ответе.
Поле
supported_questions
Тип
array[string]
Обязательно
Не применимо
Описание
Поддерживаемые внутренние ключи намерения.
Поле
metadata
Тип
object
Обязательно
Не применимо
Описание
Версия конечной точки, набор правил, айанамша, часовой пояс и основа расчета.

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

В этом запросе используется поддерживаемая тематическая фраза Chaughadia для Нью-Дели с явным указанием местного времени поиска.

{
  "question": "chaughadia",
  "date": "2026-04-30",
  "time": "10:30",
  "city": "New Delhi",
  "lat": 28.62137,
  "lng": 77.2148,
  "ayanamsha": "lahiri",
  "language": "en"
}

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

Этот ответ был сгенерирован из текущей реализации конечной точки V2 для примера полезной нагрузки.

V2
{
  "intent": "chaughadia",
  "question": "chaughadia",
  "answer": "Chaughadia for 2026-04-30 contains 8 day periods and 8 night periods.",
  "date": "2026-04-30",
  "location": {
    "lat": 28.62137,
    "lng": 77.2148
  },
  "period": null,
  "current_period": {
    "id": "chaughadia_day_3",
    "name": "Udveg",
    "section": "day",
    "start": "2026-04-30T08:59:55.662681+05:30",
    "end": "2026-04-30T10:39:14.980549+05:30",
    "start_time": "08:59:55",
    "end_time": "10:39:14",
    "quality": "inauspicious",
    "duration_minutes": 99.32,
    "index": 3
  },
  "sections": {
    "day": [
      {
        "id": "chaughadia_day_1",
        "name": "Shoobh",
        "section": "day",
        "start": "2026-04-30T05:41:17.026945+05:30",
        "end": "2026-04-30T07:20:36.344813+05:30",
        "start_time": "05:41:17",
        "end_time": "07:20:36",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 1
      },
      {
        "id": "chaughadia_day_2",
        "name": "Rog",
        "section": "day",
        "start": "2026-04-30T07:20:36.344813+05:30",
        "end": "2026-04-30T08:59:55.662681+05:30",
        "start_time": "07:20:36",
        "end_time": "08:59:55",
        "quality": "inauspicious",
        "duration_minutes": 99.32,
        "index": 2
      },
      {
        "id": "chaughadia_day_3",
        "name": "Udveg",
        "section": "day",
        "start": "2026-04-30T08:59:55.662681+05:30",
        "end": "2026-04-30T10:39:14.980549+05:30",
        "start_time": "08:59:55",
        "end_time": "10:39:14",
        "quality": "inauspicious",
        "duration_minutes": 99.32,
        "index": 3
      },
      {
        "id": "chaughadia_day_4",
        "name": "Chal",
        "section": "day",
        "start": "2026-04-30T10:39:14.980549+05:30",
        "end": "2026-04-30T12:18:34.298417+05:30",
        "start_time": "10:39:14",
        "end_time": "12:18:34",
        "quality": "good",
        "duration_minutes": 99.32,
        "index": 4
      },
      {
        "id": "chaughadia_day_5",
        "name": "Laabh",
        "section": "day",
        "start": "2026-04-30T12:18:34.298417+05:30",
        "end": "2026-04-30T13:57:53.616285+05:30",
        "start_time": "12:18:34",
        "end_time": "13:57:53",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 5
      },
      {
        "id": "chaughadia_day_6",
        "name": "Amrut",
        "section": "day",
        "start": "2026-04-30T13:57:53.616285+05:30",
        "end": "2026-04-30T15:37:12.934153+05:30",
        "start_time": "13:57:53",
        "end_time": "15:37:12",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 6
      },
      {
        "id": "chaughadia_day_7",
        "name": "Kaal",
        "section": "day",
        "start": "2026-04-30T15:37:12.934153+05:30",
        "end": "2026-04-30T17:16:32.252021+05:30",
        "start_time": "15:37:12",
        "end_time": "17:16:32",
        "quality": "inauspicious",
        "duration_minutes": 99.32,
        "index": 7
      },
      {
        "id": "chaughadia_day_8",
        "name": "Shoobh",
        "section": "day",
        "start": "2026-04-30T17:16:32.252021+05:30",
        "end": "2026-04-30T18:55:51.569889+05:30",
        "start_time": "17:16:32",
        "end_time": "18:55:51",
        "quality": "auspicious",
        "duration_minutes": 99.32,
        "index": 8
      }
    ],
    "night": [
      {
        "id": "chaughadia_night_1",
        "name": "Amrut",
        "section": "night",
        "start": "2026-04-30T18:55:51.569885+05:30",
        "end": "2026-04-30T20:16:25.829909+05:30",
        "start_time": "18:55:51",
        "end_time": "20:16:25",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 1
      },
      {
        "id": "chaughadia_night_2",
        "name": "Chal",
        "section": "night",
        "start": "2026-04-30T20:16:25.829909+05:30",
        "end": "2026-04-30T21:37:00.089933+05:30",
        "start_time": "20:16:25",
        "end_time": "21:37:00",
        "quality": "good",
        "duration_minutes": 80.57,
        "index": 2
      },
      {
        "id": "chaughadia_night_3",
        "name": "Rog",
        "section": "night",
        "start": "2026-04-30T21:37:00.089933+05:30",
        "end": "2026-04-30T22:57:34.349957+05:30",
        "start_time": "21:37:00",
        "end_time": "22:57:34",
        "quality": "inauspicious",
        "duration_minutes": 80.57,
        "index": 3
      },
      {
        "id": "chaughadia_night_4",
        "name": "Kaal",
        "section": "night",
        "start": "2026-04-30T22:57:34.349957+05:30",
        "end": "2026-05-01T00:18:08.609981+05:30",
        "start_time": "22:57:34",
        "end_time": "24:18:08",
        "quality": "inauspicious",
        "duration_minutes": 80.57,
        "index": 4
      },
      {
        "id": "chaughadia_night_5",
        "name": "Laabh",
        "section": "night",
        "start": "2026-05-01T00:18:08.609981+05:30",
        "end": "2026-05-01T01:38:42.870005+05:30",
        "start_time": "24:18:08",
        "end_time": "25:38:42",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 5
      },
      {
        "id": "chaughadia_night_6",
        "name": "Udveg",
        "section": "night",
        "start": "2026-05-01T01:38:42.870005+05:30",
        "end": "2026-05-01T02:59:17.130029+05:30",
        "start_time": "25:38:42",
        "end_time": "26:59:17",
        "quality": "inauspicious",
        "duration_minutes": 80.57,
        "index": 6
      },
      {
        "id": "chaughadia_night_7",
        "name": "Shoobh",
        "section": "night",
        "start": "2026-05-01T02:59:17.130029+05:30",
        "end": "2026-05-01T04:19:51.390053+05:30",
        "start_time": "26:59:17",
        "end_time": "28:19:51",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 7
      },
      {
        "id": "chaughadia_night_8",
        "name": "Amrut",
        "section": "night",
        "start": "2026-05-01T04:19:51.390053+05:30",
        "end": "2026-05-01T05:40:25.650077+05:30",
        "start_time": "28:19:51",
        "end_time": "29:40:25",
        "quality": "auspicious",
        "duration_minutes": 80.57,
        "index": 8
      }
    ]
  },
  "periods": [
    {
      "id": "chaughadia_day_1",
      "name": "Shoobh",
      "section": "day",
      "start": "2026-04-30T05:41:17.026945+05:30",
      "end": "2026-04-30T07:20:36.344813+05:30",
      "start_time": "05:41:17",
      "end_time": "07:20:36",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 1
    },
    {
      "id": "chaughadia_day_2",
      "name": "Rog",
      "section": "day",
      "start": "2026-04-30T07:20:36.344813+05:30",
      "end": "2026-04-30T08:59:55.662681+05:30",
      "start_time": "07:20:36",
      "end_time": "08:59:55",
      "quality": "inauspicious",
      "duration_minutes": 99.32,
      "index": 2
    },
    {
      "id": "chaughadia_day_3",
      "name": "Udveg",
      "section": "day",
      "start": "2026-04-30T08:59:55.662681+05:30",
      "end": "2026-04-30T10:39:14.980549+05:30",
      "start_time": "08:59:55",
      "end_time": "10:39:14",
      "quality": "inauspicious",
      "duration_minutes": 99.32,
      "index": 3
    },
    {
      "id": "chaughadia_day_4",
      "name": "Chal",
      "section": "day",
      "start": "2026-04-30T10:39:14.980549+05:30",
      "end": "2026-04-30T12:18:34.298417+05:30",
      "start_time": "10:39:14",
      "end_time": "12:18:34",
      "quality": "good",
      "duration_minutes": 99.32,
      "index": 4
    },
    {
      "id": "chaughadia_day_5",
      "name": "Laabh",
      "section": "day",
      "start": "2026-04-30T12:18:34.298417+05:30",
      "end": "2026-04-30T13:57:53.616285+05:30",
      "start_time": "12:18:34",
      "end_time": "13:57:53",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 5
    },
    {
      "id": "chaughadia_day_6",
      "name": "Amrut",
      "section": "day",
      "start": "2026-04-30T13:57:53.616285+05:30",
      "end": "2026-04-30T15:37:12.934153+05:30",
      "start_time": "13:57:53",
      "end_time": "15:37:12",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 6
    },
    {
      "id": "chaughadia_day_7",
      "name": "Kaal",
      "section": "day",
      "start": "2026-04-30T15:37:12.934153+05:30",
      "end": "2026-04-30T17:16:32.252021+05:30",
      "start_time": "15:37:12",
      "end_time": "17:16:32",
      "quality": "inauspicious",
      "duration_minutes": 99.32,
      "index": 7
    },
    {
      "id": "chaughadia_day_8",
      "name": "Shoobh",
      "section": "day",
      "start": "2026-04-30T17:16:32.252021+05:30",
      "end": "2026-04-30T18:55:51.569889+05:30",
      "start_time": "17:16:32",
      "end_time": "18:55:51",
      "quality": "auspicious",
      "duration_minutes": 99.32,
      "index": 8
    },
    {
      "id": "chaughadia_night_1",
      "name": "Amrut",
      "section": "night",
      "start": "2026-04-30T18:55:51.569885+05:30",
      "end": "2026-04-30T20:16:25.829909+05:30",
      "start_time": "18:55:51",
      "end_time": "20:16:25",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 1
    },
    {
      "id": "chaughadia_night_2",
      "name": "Chal",
      "section": "night",
      "start": "2026-04-30T20:16:25.829909+05:30",
      "end": "2026-04-30T21:37:00.089933+05:30",
      "start_time": "20:16:25",
      "end_time": "21:37:00",
      "quality": "good",
      "duration_minutes": 80.57,
      "index": 2
    },
    {
      "id": "chaughadia_night_3",
      "name": "Rog",
      "section": "night",
      "start": "2026-04-30T21:37:00.089933+05:30",
      "end": "2026-04-30T22:57:34.349957+05:30",
      "start_time": "21:37:00",
      "end_time": "22:57:34",
      "quality": "inauspicious",
      "duration_minutes": 80.57,
      "index": 3
    },
    {
      "id": "chaughadia_night_4",
      "name": "Kaal",
      "section": "night",
      "start": "2026-04-30T22:57:34.349957+05:30",
      "end": "2026-05-01T00:18:08.609981+05:30",
      "start_time": "22:57:34",
      "end_time": "24:18:08",
      "quality": "inauspicious",
      "duration_minutes": 80.57,
      "index": 4
    },
    {
      "id": "chaughadia_night_5",
      "name": "Laabh",
      "section": "night",
      "start": "2026-05-01T00:18:08.609981+05:30",
      "end": "2026-05-01T01:38:42.870005+05:30",
      "start_time": "24:18:08",
      "end_time": "25:38:42",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 5
    },
    {
      "id": "chaughadia_night_6",
      "name": "Udveg",
      "section": "night",
      "start": "2026-05-01T01:38:42.870005+05:30",
      "end": "2026-05-01T02:59:17.130029+05:30",
      "start_time": "25:38:42",
      "end_time": "26:59:17",
      "quality": "inauspicious",
      "duration_minutes": 80.57,
      "index": 6
    },
    {
      "id": "chaughadia_night_7",
      "name": "Shoobh",
      "section": "night",
      "start": "2026-05-01T02:59:17.130029+05:30",
      "end": "2026-05-01T04:19:51.390053+05:30",
      "start_time": "26:59:17",
      "end_time": "28:19:51",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 7
    },
    {
      "id": "chaughadia_night_8",
      "name": "Amrut",
      "section": "night",
      "start": "2026-05-01T04:19:51.390053+05:30",
      "end": "2026-05-01T05:40:25.650077+05:30",
      "start_time": "28:19:51",
      "end_time": "29:40:25",
      "quality": "auspicious",
      "duration_minutes": 80.57,
      "index": 8
    }
  ],
  "warnings": [],
  "panchang_context": {
    "sunrise": "05:41:17",
    "sunset": "18:55:51",
    "weekday": {
      "number": 5,
      "name": "Thursday"
    },
    "rahu_kalam": {
      "start": "13:57",
      "end": "15:37"
    }
  },
  "supported_questions": [
    "abhijit_muhurat_today",
    "rahu_kaal_today",
    "brahma_muhurat",
    "do_ghati_muhurat",
    "hora",
    "chaughadia",
    "gowri_panchangam",
    "panchak_today",
    "bhadra_today"
  ],
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "astrosage_daily_muhurat_qa_v1",
    "ayanamsha": "lahiri",
    "timezone_used": "Asia/Kolkata",
    "calculation_basis": "day_and_night_each_split_into_8_chaughadia_periods",
    "calculation_notes": [
      "Full day/night table output is deterministic from sunrise/sunset and fixed weekday ordering conventions."
    ]
  }
}

FAQ

Поддерживает ли эта конечная точка специальные вопросы?

Нет. Конечная точка официально ограничена поддерживаемыми ежедневными тематическими фразами Ведического Мухурата: Абхиджит Мухурат, Rahu Каал, Брахма Мухурат, До Гхати, Хора, Чаугхадия, Гоури Panchangam, Панчак и Бхадра. Неподдерживаемый текст возвращает 400 вместо предполагаемого ответа.

Как выбирается текущий период?

Если вы отправляете время в формате ЧЧ:ММ или ЧЧ:ММ:СС, конечная точка определяет активный период в это локальное время стены. Если время для сегодняшнего дня опущено, используется текущее местное время для определенного местоположения; для прошлых или будущих дат current_period — это null.

Должны ли разработчики отправлять tz_str?

Обычно нет. Если указаны широта и долгота, опустите tz_str, и API автоматически определит часовой пояс. Отправляйте tz_str только в том случае, если вам нужно отменить определение часового пояса, точно воспроизвести калибровку или использовать специальный режим, такой как LMT.

Что астрологам следует знать о правилах?

Конечная точка использует ведический движок восхода и захода солнца, отображение Каала weekday-specific Rahu, разделение дня и ночи для периодов Хора, Чаугхадия, Гоури и До Гхати, а также Panchang3ZXQ Панчак и Бхадра. Метаданные раскрывают основу расчета, поэтому результат можно проверить.

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