API Sao Cố Định

Từ ngày sinh, giờ, chênh lệch UTC và tọa độ được cung cấp, endpoint tính các điểm sinh và duyệt danh mục các sao cố định lớn dựa trên truyền thống Vivian Robson và Ptolemy – những sao sáng, có trọng số chiêm tinh, không phải toàn bộ bầu trời. Với mỗi sao, nó kiểm tra các điểm sinh để tìm hợp sao, và nếu nằm trong quỹ đạo, ghi lại tiếp xúc cùng giá trị quỹ đạo chính xác. Kết quả trong data.stars là danh sách các lần sao-điểm chạm: sao nào, điểm sinh nào, và độ gần của sự căn chỉnh, vì vậy một hợp sao nửa độ được xem mạnh hơn so với ở rìa quỹ đạo. Chỉ xét hợp sao – kỹ thuật coi sao có ý nghĩa khi một điểm biểu đồ nằm trên nó, không phải khi nó tạo góc dọc mà các hành tinh tạo với nhau. Điều này đưa ra các sao đã được các nguồn cổ điển chỉ ra là may mắn hoặc nguy hiểm, sẵn sàng để ghép với bản sao ý nghĩa sao của bạn.

curl -X POST https://api.astroway.info/v1/fixed-stars \
  -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
}'

{
  "ok": true,
  "data": {
    "stars": [
      {
        "star": "Regulus",
        "point": "Mercury",
        "orb": 0.4
      },
      {
        "star": "Algol",
        "point": "Mars",
        "orb": 1.1
      }
    ]
  }
}

Dùng endpoint này khi bản đọc biểu đồ muốn thêm lớp chi tiết của các sao có tên – một người giải thích truyền thống hoặc biết sao cố định, một công cụ tạo báo cáo đánh dấu tiếp xúc ấn tượng với Algol hoặc sao hoàng gia Regulus, hoặc một công cụ giáo dục dạy câu chuyện phía sau những sao sáng nhất. Thiết kế chỉ hợp sao, quỹ đạo chặt chẽ giúp kết quả gọn gàng: bạn nhận được một vài tiếp xúc đáng đề cập thay vì nhiễu, dễ dàng hiển thị dưới dạng danh sách nổi bật ngắn. Cung cấp cùng dữ liệu sinh mà bạn đã gửi cho endpoint natal-chart và các lần sao sẽ khớp với vị trí hành tinh và góc đã có trong biểu đồ, cho phép bạn chú thích hành tinh hoặc góc với sao đồng vị. Vì danh mục được chọn lọc theo các sao truyền thống quan trọng, bạn có thể đính kèm văn bản giải thích đã chuẩn bị cho mỗi sao mà không cần tự tạo danh sách.

Danh mục sao tuân theo lựa chọn được truyền lại qua Vivian Robson và Ptolemy – các sao cố định quan trọng chiêm tinh, không phải khảo sát toàn bầu trời. Vị trí sinh và kinh độ sao được tính bằng Swiss Ephemeris (Astrodienst) engine trong cung hoàng đạo nhiệt đới, và chỉ trả về các hợp sao trong quỹ đạo.