AstroWay/api v2.201.6 · vi
tất cả hệ thống hoạt động bình thường
// astrology api · POST /v1/vedic/dashas/vimshottari/maha

API Vimshottari Mahadasha

Vimshottari là chu kỳ 120 năm của các thời kỳ hành tinh, tạo nền tảng cho thời gian Vedic. Endpoint này đọc vị trí của Mặt Trời tinh túy tại thời điểm sinh, xác định nakshatra mà nó chiếm giữ, và từ điểm duy nhất đó, triển khai chuỗi có thứ tự của các Mahadasha - các thời kỳ cuộc sống chính, mỗi thời kỳ được cai trị bởi một trong số chín graha - cùng với các ngày lịch chính xác giới hạn chúng.

Endpoint
POST /v1/vedic/dashas/vimshottari/maha
Cost
50 credits
Latency
~62 ms
Tier
Tier 3
// 01 / What it computes

API Vimshottari Mahadasha

Endpoint chuyển đổi ngày sinh, giờ đồng hồ và độ lệch UTC thành ngày Julian, sau đó truy vấn Swiss Ephemeris để lấy kinh độ địa tâm của Mặt Trời và áp dụng ayanamsa Lahiri để chuyển nó từ hoàng đạo nhiệt đới sang hoàng đạo tinh túy. Kinh độ tinh túy đó xác định nakshatra sinh và phần đã trôi qua trong đó, từ đó xác định bao nhiêu thời kỳ của hành tinh cai trị đầu tiên còn lại tại thời điểm sinh. Từ đó, nó trình bày chuỗi Vimshottari 120 năm đầy đủ theo thứ tự chuẩn - Ketu, Kim Tinh, Mặt Trời, Mặt Trăng, Hỏa Tinh, Rahu, Mộc Tinh, Thủy Tinh, Thủy Tinh - mỗi Mahadasha mang khoảng thời gian được phân bổ và ngày bắt đầu và kết thúc cụ thể. Phản hồi cũng trả về nakshatra sinh, kinh độ tinh túy của Mặt Trời và giá trị ayanamsa được sử dụng, để dòng thời gian hoàn toàn có thể kiểm toán.

// 02 / Live request

POST/v1/vedic/dashas/vimshottari/maha

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-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "system": "vimshottari",
    "level": "maha",
    "ayanamsa": 23.85,
    "moonSiderealLongitude": 258.97,
    "nakshatra": "Purva Ashadha",
    "periods": [
      {
        "lord": "Venus",
        "start": "1986-02-11",
        "end": "2006-02-11"
      },
      {
        "lord": "Sun",
        "start": "2006-02-11",
        "end": "2012-02-11"
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
// 04 / When to use it

When to use it

Sử dụng endpoint này khi bạn cần khung xương dasha cấp cao - các thời kỳ vi mô định hình các chương cuộc sống của một người - thay vì chi tiết cấp ngày. Đây là lệnh gọi tự nhiên đầu tiên cho một dòng thời gian dự đoán: hiển thị chuỗi các thời kỳ chính, làm nổi bật thời kỳ nào đang hoạt động cho một ngày nhất định, và cho phép người dùng đào sâu từ đó. Vì toàn bộ chuỗi theo một cách xác định từ vị trí của Mặt Trời, bạn có thể tính toán nó một lần tại đăng ký và lưu trữ nó vô thời hạn. Khi bạn cần các thời kỳ con lồng nhau bên trong một Mahadasha nhất định, hãy chuyển đến các endpoint chuyên dụng antardasha, pratyantar, sookshma và prana trong cùng gia đình Vimshottari.

// 05 / Notes

Notes

Đường này chỉ trả về lớp Mahadasha (thời kỳ chính). Các phân chia tinh tế hơn - antardasha, pratyantar, sookshma và prana - tồn tại tại các endpoint riêng dưới /v1/vedic/dashas/vimshottari/*. Tính toán theo truyền thống Parashara như được mã hóa trong Bṛhat Parāśara Horā Śāstra, với hoàng đạo tinh túy và ayanamsa Lahiri làm khung tham chiếu mặc định.

Try the Vimshottari Mahadasha API

Grab a key and make your first call in under a minute.

99,9% SLA · gói trả phí · 30 ngày trạng thái →