Поиск ведических ежедневных мухуратов
Поиск ведических ежедневных мухуратов
/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 рекомендуется использовать координаты.
Форма ответа
Пример реального запроса
В этом запросе используется поддерживаемая тематическая фраза Chaughadia для Нью-Дели с явным указанием местного времени поиска.
{
"question": "chaughadia",
"date": "2026-04-30",
"time": "10:30",
"city": "New Delhi",
"lat": 28.62137,
"lng": 77.2148,
"ayanamsha": "lahiri",
"language": "en"
}Пример реального ответа
Этот ответ был сгенерирован из текущей реализации конечной точки 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 Панчак и Бхадра. Метаданные раскрывают основу расчета, поэтому результат можно проверить.