Chiêm tinh Vedic qua API: từ Parashara đến Lal Kitab trong 354 endpoint

Chiêm tinh Vedic là truyền thống chiêm tinh liên tục lâu đời nhất thế giới. Các phương pháp chính quy của nó (BPHS, Jaimini Sutras, Lal Kitab, KP) được dùng hằng ngày ở Ấn Độ: cho người mai mối hôn nhân, chọn ngày, chẩn đoán vận mệnh chủ động. Nhưng tiếp cận các phép tính chất lượng bằng lập trình - cho đến gần đây vẫn là một nỗi khổ.

AstroWay v2.19 khắc phục điều đó: hơn 354 endpoint Vedic, được kiểm tra chéo với PyJHora (bản triển khai tham chiếu bằng Python), với các sai khác được ghi lại.

Dù cả hai hệ hoàng đạo được tính từ cùng các vị trí hành tinh (qua Swiss Ephemeris), về khái niệm chúng khác nhau:

Vedic không phải “phương án thay thế” cho chiêm tinh phương Tây - đó là một hệ thống riêng với khung logic nội tại của nó. Các nhà tích hợp làm ứng dụng đa truyền thống (tử vi di động, mai mối, tử vi hằng ngày) thường muốn cả hai - và khi đó một API thay vì hai nhà cung cấp bên ngoài là khoản tiết kiệm đáng kể.

Phần lớn đối thủ chỉ có Vimshottari (chu kỳ 120 năm, phổ biến nhất). AstroWay bao phủ:

1. Vimshottari (120 năm): chuẩn BPHS, dùng rộng rãi
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ị theo paksha
4. Kalachakra (cung làm chủ MD): hệ thống phức tạp nhất, paramayu khác nhau theo từng lá số
5. Chara (Jaimini, cung động): cho dự đoán dựa trên cung
6. Tribhagi (54 = Vimshottari/2 + phần bổ sung): Vimshottari tăng tốc
7. Shatabdika (100 năm): số lượng nguồn khác nhau
8. Shodashottari (116 năm): cho lá số pha trộn paksha
9. Sthira (dasha chu kỳ cố định hiếm gặp)
10. Shoola (phương pháp cross-rasi)

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

Lá số phân chia là góc nhìn đệ quy vào cùng một lá số gốc ở các tỷ lệ khác nhau. D9 (Navamsha) - quan trọng nhất cho hôn nhân. D10 (Dashamsha) - sự nghiệp. D60 (Shashtyamsha) - cấp chi tiết nhất.

Một lần gọi /v1/vedic/vargas trả về cả 16 phân chia cùng lúc - nhà tích hợp không phải gửi 16 yêu cầu riêng.

5 yếu tố + các yếu tố phụ:

• 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 trạm Mặt Trăng)
• Choghadia (ngày và đêm, mỗi phần 8 khối về mức cát tường, mỗi khối khoảng một tiếng rưỡi)
• Hora (giờ hành tinh)
• Rahu-kaal (khung 1,5 giờ bất lợi mỗi ngày)

Gọi /v1/vedic/panchang/full - bạn nhận cả 8 yếu tố trong một JSON cho ngày/địa điểm cụ thể.

Yoga trong Vedic là một tổ hợp hành tinh đặc biệt tạo nên một khuôn mẫu cuộc đời rõ rệt. Parashara (BPHS) mô tả hàng trăm yoga; AstroWay triển khai những yoga được trích dẫn nhiều nhất:

• Raja: tổ hợp quyền lực/được công nhận
• Dhana: của cải
• Dharma-Karmadhipati: con đường nghề nghiệp
• Pancha-Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 hành tinh ở nhà kendra trong cung của chính mình)
• Gajakesari: Mặt Trăng + Mộc tinh ở kendra
• Adhi: Thủy tinh/Kim tinh/Mộc tinh ở nhà 6/7/8 tính từ Mặt Trăng

Thêm các yoga riêng của Jaimini: karaka-yoga (8 chara karaka ở các nhà quan trọng), karakamsa (phép chiếu 12 nhà với AK trong D9), shubha-graha (cát tinh chức năng theo BPHS Adhyaya 34).

Dosha là sự tổn hại do hành tinh gây khó khăn cho một lĩnh vực cụ thể của cuộc sống. AstroWay bao phủ ba trường phái:

• Parashara: Mangal Dosha (Hỏa tinh), Kaal Sarp (các hành tinh nằm giữa Rahu và Ketu), Pitru (karma tổ tiên), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (cách diễn giải riêng của Lal Kitab), cùng các dosha đặc thù 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 của Ấn Độ (Punjab thường dùng LK, Tamil Nadu dùng KP, nơi nào cũng dùng Parashara) - một API thay vì ba.

Quy trình so khớp cổ điển của Ấn Độ:

1. Ashtakoot (Guna Milan): thang 8 phần, tối đa 36 điểm. Dưới 18 = độ tương hợp thấp. Phổ biến nhất ở Bắc/Trung Ấn Độ.
2. Dashakoota: thang 10 phần, biến thể Nam Ấn Độ.
3. Kiểm tra Manglik: then chốt với lá số bị Hỏa tinh gây tổn hại.
4. Mangal match: bù trừ Hỏa tinh - Hỏa tinh.
5. Bhrigu match: lớp dự đoán từ Bhrigu Samhita.

Tất cả qua /v1/vedic/compatibility/full - một lần gọi, báo cáo tương hợp đầy đủ.

“Muhurta” là thời điểm cát tường để khởi sự một việc. Các sự kiện kinh điển:

• Marriage muhurta (đám cưới)
• Vehicle purchase (mua xe)
• Business start (khai trương kinh doanh)
• Travel (du lịch)
• Naming ceremony (Namakaran: đặt tên cho trẻ sơ sinh)
• Phẫu thuật, bắt đầu học, đầu tư, mua bất động sản, griha-pravesh (tân gia), đính hôn, vụ kiện

/v1/vedic/muhurat/{event} trả về 3 ngày cát tường tốt nhất trong khoảng thời gian cho trước.

Lahiri là mặc định (Chitra Paksha, chuẩn chính thức của chính phủ Ấn Độ). Qua tham số ayanamsa bạn có thể chuyển sang:

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

Mỗi loại là một độ lệch khác nhau (thường 23,5–24,0°). Với cùng một khách hàng, vị trí hành tinh trong các cung có thể khác nhau - điều này cần biết ngay từ giai đoạn thiết kế kiến trúc ứng dụng.

Mỗi endpoint có:

• Status (GREEN/YELLOW) trong docs/AUDIT-TRAIL.md
• Tiêu đề AUDIT inline trong mã nguồn kèm nguồn (BPHS Adhyaya N, Jaimini Sutras X.Y, hàm tham chiếu của PyJHora)
• Fixture snapshot-test chống hồi quy

Các sai khác so với PyJHora (nếu có - thường gặp nhất ở các phương pháp của một tác giả duy nhất như Lal Kitab) được ghi lại trong AUDIT-TRAIL - nhà tích hợp thấy chính xác độ chênh trước khi tích hợp.

# Natal Vedic chart
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",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Trả về chủ tinh Maha-dasha hiện tại, ngày kết thúc MD, chuỗi các dasha tiếp theo. Qua /maha → /antar → /pratyantar → … bạn có thể đi sâu đến cấp thứ 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ới nội dung Vedic. Truyền lang=<code> vào bất kỳ endpoint /v1/reports/* nào. Chi tiết - /languages/.

Các endpoint Vedic có giá 10, 20 hoặc 50 credit tùy theo phép tính: Lal Kitab và KP - 10, varga và các yếu tố panchang - 20, dosha Parashara, dasha, shadbala và muhurta - 50. Trên gói miễn phí (10 000 credit), con số này tương đương 200 đến 1000 lần gọi Vedic mỗi tháng. Báo cáo PDF Vedic Kundli / Lal Kitab - 5000.

• Danh mục endpoint Vedic: điều hướng qua 8 nhóm
• Vedic API marketing: tổng quan đầy đủ với ví dụ mã bằng 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