Muhurta API - اختيار تواريخ ملائمة (الفلك الفيدي الانتقائي)

Muhurta هو علم التنجيم الاختياري الفيدي: اختيار اللحظة الميمونة لحدث مهم. يقوم الـ API بمسح كل يوم في نافذة البحث الخاصة بك، ويقيمه بناءً على البانشانغا عند شروق الشمس (Tithi · Vara · Nakshatra · Yoga · Karana) لنشاط معين، ويعيد أفضل N يومًا مع شرح.

كيف يعمل

1. اختر النشاط (واحد من 12: القائمة عبر /muhurta/types)، نافذة البحث (حتى 90 يومًا) والموقع (شروق الشمس مرتبط بالإحداثيات)
2. يحسب الـ API البانشانغا عند شروق الشمس لكل يوم ويقيمه وفقًا للقواعد الكلاسيكية للنشاط (Muhurta Chintamani + B.V. Raman)
3. الاستجابة: أفضل N يومًا، مرتبة حسب score، مع البانشانغا، النافذة الفرعية لـ Abhijit Muhurat وعوامل التقييم (why)

نقاط النهاية

نقطة النهاية	الطريقة	الرصيد	الغرض
/v1/muhurta/types	GET	0	دليل 12 نشاطًا (المفتاح + السنسكريتية + الوصف)
/v1/vedic/muhurat/{activity}	POST	Tier 3	مسح نافذة لنشاط واحد ← أفضل N يومًا (JSON)
/v1/reports/muhurta	POST	Tier 7	تقرير جاهز للتواريخ الميمونة - PDF (افتراضي)، HTML أو Markdown (format)

12 نشاطًا

marriage (Vivah) · vehicle-purchase (Vahana) · business-start (Vyapara) · travel (Yatra) · naming-ceremony (Namkaran) · surgery (Shastrakarma) · education-start (Vidyarambha) · investment (Dhana Sthapana) · property-purchase (Griha Pravesh) · journey-long · name-change · general-auspicious.

التقرير

POST /v1/reports/muhurta يعيد تقرير A4 قياسيًا بنفس طريقة باقي /v1/reports/* - عرض متزامن في الاستجابة: PDF افتراضيًا، format: "html" يعطي HTML مكتفيًا ذاتيًا، format: "markdown" نفس المستند في Markdown، كلاهما بدون تخزين. توصية عليا، قائمة مرتبة بالأيام، بانشانغا كل يوم، Abhijit Muhurat وعوامل التقييم كمبرر. يدعم white-label (الشعار/الألوان/الخط) للمفاتيح المرتبطة بالحساب.

مثال

curl -X POST https://api.astroway.info/v1/reports/muhurta \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "activity": "marriage", "search_window_start": "2026-07-01",
        "search_window_end": "2026-07-31", "latitude": 28.61,
        "longitude": 77.21, "timezoneOffset": 5.5, "topN": 5 }'
# → { "url": "https://api.astroway.info/reports/…-muhurta.pdf", "page_count": 3, "expires_at": "…" }
# (format "html" or "markdown" returns the document itself)

ملاحظة

Muhurta هو نموذج استشاري يستند إلى النصوص الكلاسيكية، وليس توجيهًا. بالنسبة للعمليات الجراحية والأحداث الطبية، فإن التخطيط الحديث له الأولوية.