API Biểu đồ chuyển động

Endpoint /transits nhận dữ liệu sinh của một người – ngày sinh, giờ, chênh lệch UTC, vĩ độ, kinh độ và hệ nhà – và một thời điểm mục tiêu riêng. Nó chuyển ngày và giờ mục tiêu sang ngày Julian, yêu cầu engine Swiss Ephemeris cung cấp kinh độ, vĩ độ và tốc độ địa tâm của mọi thiên thể chuyển động, rồi đưa các vị trí này vào các nhà được tính từ vị trí sinh. Phản hồi chứa các hành tinh chuyển động cùng cung và vị trí nhà của chúng, các cusp nhà sinh, và toàn bộ lưới khía cạnh tính giữa các thiên thể chuyển động, mỗi mục có cờ áp dụng hoặc tách rời và bán kính chính xác. Nó cũng trả về các khía cạnh song song và antiscia (điểm phản chiếu) cho độ lệch và công việc trục solstice. Chuyển động lùi được đánh dấu dựa trên tốc độ của thiên thể, để bạn thấy chuyển động nào là trực tiếp, đứng yên, hoặc di chuyển ngược lại tại thời điểm yêu cầu.

curl -X POST https://api.astroway.info/v1/transits \
  -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,
  "transitDate": "2026-06-15",
  "transitTime": "12:00:00",
  "transitTzOffset": 3
}'

{
  "ok": true,
  "data": {
    "input": {},
    "julianDay": 2461206.875,
    "planets": [
      {
        "name": "Sun",
        "longitude": 84.29,
        "sign": "Gemini",
        "house": 11
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "parallelAspects": [
      "…"
    ],
    "antiscia": [
      "…"
    ]
  }
}

Dùng cái này khi bạn muốn toàn bộ bầu trời như hiện trên biểu đồ của ai đó vào một ngày nhất định – widget chuyển động hằng ngày, bảng kiểu thời tiết 'cái gì đang ở trên đầu' hoặc khung thô mà AI đọc trước khi mô tả khí hậu chiêm tinh hiện tại. Vì nó trả về biểu đồ chuyển động trên khung nhà sinh thay vì danh sách đã chọn lọc các tiếp xúc chuyển động-sinh, nó phù hợp khi bạn cần bản chụp cấu trúc. Nếu bạn muốn các lần chuyển động-sinh có thời gian được quét qua một khoảng ngày – ngày chính xác, điểm vào, điểm dừng – hãy dùng endpoint transit-calendar, được xây dựng cho công việc thời gian này. Kết hợp cả hai: endpoint này cho biểu đồ thời điểm, calendar cho danh sách sự kiện tương lai.

Xem các chuyển động hôm nay so với biểu đồ của bạn →

Hãy rõ ràng về phạm vi: cái này trả về biểu đồ chuyển động đặt lên khung nhà sinh, không phải danh sách khía cạnh chuyển động-sinh đã lọc trước. Lưới khía cạnh được tính giữa các thiên thể chuyển động, không phải giữa chuyển động và điểm sinh. Để tính thời gian chuyển động-sinh qua một khoảng ngày, dùng /transit-calendar. Các nhà tuân theo hệ sinh bạn chọn; cung nhiệt đới và Swiss Ephemeris luôn được dùng.