Chiêm tinh Vedic thông qua API: từ Parasara đến Lal Kitab trong 354 endpoint

Vedic chiêm tinh là truyền thống chiêm tinh lâu đời nhất liên tục trên thế giới. Các phương pháp chính thức (BPHS, Jaimini Sutras, Lal Kitab, KP) của nó vẫn được sử dụng hàng ngày ở Ấn Độ: để mai mối hôn nhân, lựa chọn ngày giờ, chẩn đoán tiền định sớm. Nhưng tiếp cận lập trình đến những tính toán chất lượng — cho đến gần đây vẫn còn là nỗi đau.

AstroWay v2.19 khắc phục điều đó: hơn 354+ đầu cuối Vedic, được kiểm tra chéo với PyJHora (triển khai Python tham chiếu), với những khác biệt đã được ghi chép.

Mặc dù cả hai cung hoàng đạo đều được tính toán từ cùng vị trí hành tinh (thông qua Swiss Ephemeris), nhưng về mặt khái niệm chúng hoàn toàn khác biệt:

Vedic không phải là “lựa chọn thay thế” cho phương Tây — đó là một hệ thống riêng biệt với khuôn khổ logic nội tại riêng. Các nhà tích hợp xây dựng ứng dụng đa truyền thống (horoscope di động, mai mối, tử vi hàng ngày) thường muốn cả hai — và ở đây, một API thay vì hai bên thứ ba là khoản tiết kiệm đáng kể.

Hầu hết đối thủ chỉ hỗ trợ Vimshottari (chu kỳ 120 năm, phổ biến nhất). AstroWay hỗ trợ:

1. Vimshottari (120 năm) — tiêu chuẩn BPHS, xuyên suốt
2. Yogini (36 năm) — dự đoán nhanh hơn, 8 hành tinh
3. Ashtottari (108 năm) — truyền thống Ardradi, khuyến nghị paksha
4. Kalachakra (cung làm chủ MD) — hệ thống phức tạp nhất, paramayu thay đổi theo bản đồ
5. Chara (Jaimini di động) — cho dự đoán dựa trên cung
6. Tribhagi (54 = Vimshottari/2 + extras) — Vimshottari tăng tốc
7. Shatabdika (100 năm) — số lượng nguồn thay đổi
8. Shodashottari (116 năm) — cho bản đồ hỗn hợp paksha
9. Sthira (hiếm, dasa thời gian cố định)
10. Shoola (phương pháp cross-rasi)

Mỗi hệ thống hỗ trợ 5 cấp: Maha → Antar → Pratyantar → Sookshma → Prana.

Bản đồ phân chia là cái nhìn đệ quy về cùng một bản đồ natal ở các quy mô khác nhau. D9 (Navamsha) quan trọng nhất cho hôn nhân. D10 (Dashamsha) cho sự nghiệp. D60 (Shashtyamsha) là cấp độ tinh tế nhất.

Một lần gọi đến /v1/vedic/vargas trả về tất cả 16 phân chia cùng lúc — nhà tích hợp không cần thực hiện 16 yêu cầu riêng biệt.

5 yếu tố + phụ trợ:

• Tithi (ngày âm lịch, 30 phần của chu kỳ mặt trăng)
• Karana (nửa tithi, 11 loại)
• Yoga (yoga ngày, 27 loại, dựa trên tổng kinh độ Mặt Trời + Mặt Trăng)
• Nakshatra (một trong 27 nakshatra mặt trăng)
• Choghadia (8 khối nửa giờ lành)
• Hora (giờ hành tinh)
• Rahu-kaal (cửa sổ không lành 1.5 giờ hàng ngày)

Gọi /v1/vedic/panchang/full — bạn nhận được cả 8 yếu tố trong một JSON cho ngày/thời gian và vị trí cụ thể.

Yoga trong Vedic là sự kết hợp hành tinh đặc biệt tạo nên mô hình cuộc sống đáng chú ý. Parashara (BPHS) mô tả hàng trăm; AstroWay triển khai những yoga được trích dẫn nhiều nhất:

• Raja — sự kết hợp quyền lực/uy tín
• Dana — giàu có
• Dharma-Karmadipati — con đường sự nghiệp
• Pancha-Mahapurusha — Ruchaka/Bhadra/Hamsa/Malavya/Sasha (5 hành tinh trong nhà kendra ở dấu riêng)
• Gajakesari — Mặt Trăng + Mộc Tinh trong nhà kendra
• Adhi — Thủy Tinh/Hỏa Tinh/Mộc Tinh trong nhà 6/7/8 từ Mặt Trăng

Cộng với chuyên biệt Jaimini: karaka-yoga (8 chara-karaka trong nhà quan trọng), karakamsa (chiếu 12-house từ AK trong D9), shubha-graha (hành tinh lành theo BPHS Adhyaya 34).

Dosha là sự ảnh hưởng xấu của hành tinh, làm phức tạp một lĩnh vực cuộc sống cụ thể. AstroWay hỗ trợ ba trường phái:

• Parashara: Mangal Dosha (Hỏa Tinh), Kaal Sarp (các hành tinh giữa Rahu và Ketu), Pitru (nghiệp tổ tiên), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (cách giải thích riêng cho Lal Kitab), cộng với những dosha độc đáo khác của trường phái này
• KP (Krishnamurti Paddhati): chẩn đoán dựa trên sub-lord

Nếu dịch vụ mai mối của bạn phục vụ khách hàng từ nhiều vùng Ấn Độ (Punjab thường dùng LK, Tamil Nadu dùng KP, tất cả đều dùng Parashara) — một API thay vì ba.

Quá trình mai mối Ấn Độ cổ điển:

1. Ashtakoot (Guna Milan) — thang điểm 8, tối đa 36 điểm. Dưới 18 = tương thích thấp. Phổ biến nhất ở Bắc/Trung Ấn Độ.
2. Dashakoota — thang điểm 10, biến thể Nam Ấn Độ.
3. Kiểm tra Manglik — quan trọng cho bản đồ natal bị ảnh hưởng bởi Hỏa Tinh.
4. Mangal match — bù đắp cho sự kết hợp Hỏa Tinh-Hỏa Tinh.
5. Bhrigu match — lớp phủ dự đoán từ Bhrigu Samhita.

Tất cả thông qua /v1/vedic/compatibility/full — một lần gọi, báo cáo tương thích đầy đủ.

“Muhurta” là thời điểm lành cho sự kiện. Các sự kiện cổ điển:

• Marriage muhurta (đám cưới)
• Vehicle purchase (mua xe)
• Business start (khởi nghiệp)
• Travel (du lịch)
• Naming ceremony (Namakaran — đặt tên trẻ sơ sinh)
• Surgery, education start, investment, property purchase, griha-pravesh (nhập trạch), engagement, court cases

/v1/vedic/muhurat/{event} trả về top-3 ngày lành trong phạm vi đã cho.

Lahiri là mặc định (Chitra-Paksha, tiêu chuẩn chính phủ Ấn Độ). Thông qua tham số ayanamsa, bạn có thể chuyển đổi:

• raman — truyền thống B.V. Raman (phổ biến trong KP)
• krishnamurti — chuyên biệt KP
• yukteshwar — Sri Yukteshwar (khoảng cách từ Spica)
• fagan-bradley — Fagan/Bradley (sideral phương Tây)
• de-luce — De Luce
• jn-bhasin — JN Bhasin

Mỗi cái là một độ lệch khác nhau (thường 23.5–24.0°). Đối với cùng một khách hàng, vị trí hành tinh trong cung có thể khác nhau — điều này quan trọng cần biết ngay từ giai đoạn thiết kế ứng dụng của bạn.

Mỗi đầu cuối đều có:

• Trạng thái (GREEN/YELLOW) trong docs/AUDIT-TRAIL.md
• Tiêu đề inline-AUDIT trong mã nguồn với nguồn tham khảo (BPHS Adhyaya N, Jaimini Sutras X.Y, hàm tham chiếu PyJHora)
• Bản chụp kiểm thử fixture cho hồi quy

Những khác biệt so với PyJHora (nơi có) đã được ghi chép trong AUDIT-TRAIL — nhà tích hợp thấy chính xác delta trước khi tích hợp.

# Bản đồ Vedic natal
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "tzOffset": "+03:00",
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Trả về chủ hành tinh Maha-dasha hiện tại, ngày kết thúc MD, chuỗi dasa tiếp theo. Thông qua /maha → /antar → /pratyantar → … bạn có thể đi sâu đến cấp 5.

Báo cáo Vedic (PDF) có sẵn bằng 20 ngôn ngữ, bao gồm hi, ko, ja, id, tr, vi — những thị trường có nhu cầu thực sự về nội dung Vedic. Truyền lang=<code> vào bất kỳ đầu cuối /v1/reports/* nào. Chi tiết — /languages/.

Hầu hết các đầu cuối Vedic là Tier 2 (20 tín dụng). Ở gói miễn phí — 500 lượt gọi Vedic mỗi tháng. Các báo cáo lớn (tương thích đầy đủ, máy quét muhurat) — Tier 3 (50 cr). Báo cáo PDF Vedic Kundli / Lal Kitab — Tier 7 (5000 cr).

• Danh mục đầu cuối Vedic — điều hướng qua 8 nhóm
• Tiếp thị API Vedic — tổng quan đầy đủ với ví dụ mã trên 4 ngôn ngữ
• Bắt đầu nhanh — yêu cầu đầu tiên trong 5 phút
• Bảng giá — từ miễn phí đến Enterprise