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

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

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

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

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

Форма ответа

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

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

В этом запросе используется поддерживаемая тематическая фраза 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 Панчак и Бхадра. Метаданные раскрывают основу расчета, поэтому результат можно проверить.

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