Ra mắt AstroWay API: toàn bộ ngăn xếp tính toán chiêm tinh với độ chính xác của Swiss Ephemeris

Hôm nay chúng tôi công bố AstroWay API - backend tính toán dành cho các nhà phát triển đang xây dựng các ứng dụng as-tro-logia, sản phẩm horoscope, tính năng tương thích cho dating và các AI agents cần suy nghĩ về bản đồ sinh nhật.

Trong bài này, chúng tôi sẽ chia sẻ những gì thực sự bên trong API, các giải pháp không thường见 mà chúng tôi đã áp dụng, những gì chúng tôi để ý để lại trong ngoặc và cách chúng tôi đến đây. Không có lời lẽ thừa.

🕓 Ghi chú từ 2026-04-22, cập nhật 2026-05-09. Một số con số đã lỗi thời. Trạng thái hiện tại: 865 endpoint (không phải 87 khi ra mắt), 888 test snapshot CI (không phải 183), MCP server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk hiện đang sống trên các registry công cộng. Trạng thái mới nhất - ở /faq và changelog.

REST API dựa trên Swiss Ephemeris - hiện nay còn có thêm AI interpretación trên các tính toán thực tế. Cùng một engine mà các nhà as-tro-logia chuyên nghiệp đã sử dụng trong 30+ năm ở Solar Fire, Kepler, Astro Gold và Janus - độ chính xác tới một phần giây cung, được xác thực với efemeris NASA JPL và tài liệu tham khảo swetest chính thức từ Astrodienst (Astro.com).

Các con số:

• 865 endpoint: as-tro-logia natal tây, sinastria, tranzit, progresie, hướng đi, về lại, har-mon-ic, sao cố định, điểm Ả Rập, as-tro-cartography plus bộ đầy đủ Human Design
• 183 test snapshot trong CI so với output thực tế swetest CGI và danh sách sự mờ nhạt NASA - được chạy trên mỗi PR
• p50 < 100 ms, p95 < 500 ms cho các endpoint tính toán thường见
• MCP server @astroway/mcp + ba SDK trên các registry công cộng: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - cùng một API bằng ba ngôn ngữ
• MCP server: @astroway/mcp - cung cấp API dưới dạng công cụ cho Claude, GPT, Cursor và các LLM agent khác
• Gói giá dựa trên credit: gói miễn phí (10 000 credit / tháng, không cần thẻ), trả phí - từ $5 / tháng

Tài liệu đầy đủ: api.astroway.info/docs/api/. Trạng thái trực tiếp: api.astroway.info/status.

Ba năm trước, chúng tôi bắt đầu xây dựng các ứng dụng as-tro-logia dành cho người tiêu dùng. Lớp tính toán đã trở thành phần phức tạp nhất - đáng kể phức tạp hơn so với UI hoặc nội dung. Các dịch vụ hiện có hoặc:

1. Có phạm vi bề mặt (10–30 endpoint, chủ yếu chỉ là natal)
2. Đắt đỏ khi mở rộng ($0.02–$0.10 mỗi yêu cầu mà không có giảm giá lượng lớn)
3. Sử dụng các engine đóng, độ chính xác của chúng không thể kiểm tra được
4. Hướng tới as-tro-logia Vedic, còn as-tro-logia Tây được xem là thứ hai

Vậy nên chúng tôi đã tự вендор Swiss Ephemeris và viết lớp tính toán của riêng mình - trước hết cho sản phẩm tiêu dùng app.astroway.info, sau đó cho trang web marketing astroway.info, cung cấp horoscope hàng ngày cho hàng trăm nghìn khách hàng mỗi tháng.

Sau ba năm hoạt động của mã này trong sản xuất, chúng tôi đã đạt được hai kết luận:

1. Engine tính toán giống nhau nên nên được cung cấp cho các nhà phát triển khác: không phải vì họ không thể viết nó самостоятельно, mà vì stack thư viện + cache + CI về độ chính xác - là sáu tháng làm việc mà không ai nên lặp lại.
2. Phạm vi покрытия Human Design của chúng tôi (12 endpoint: bản đồ, loại, thẩm quyền, hồ sơ, cổng, kênh, đường viền, kích hoạt hành tinh, incarnation cross, định nghĩa) - thực sự độc đáo. Không có đối thủ nào cung cấp bộ đầy đủ HD qua API.

Đó là sự ra mắt.

Chúng tôi có /nakshatras, /ashtakavarga và các endpoint cho các biểu đồ divisional, nhưng không có Dasha, Panchang, Ashtakoota, KP. Nguyên nhân: trong as-tro-logia Vedic có những bất đồng chưa được giải quyết giữa các trường (chiến tranh ayanamsha, tranh cãi về cusp KP, lựa chọn trường dash). Phần Vedic được làm nhanh để đối đầu với Prokerala và VedicAstroAPI sẽ chỉ nhận được chỉ trưng.

Quyết định đã được solidify: gói Vedic là giai đoạn 3 riêng, sau khi nhu cầu về ổn định trên phương Tây và có thời gian để xác thực so với Jagannatha Hora và Parashara’s Light. Tốt hơn là không khởi động gì so với khởi động không tốt.

Một cuộc gọi /chart chi phí khoảng 1/50 lần tính toán so với /forecast-calendar 365 ngày. Giá cố định mỗi yêu cầu sẽ hoặc loại bỏ người dùng nhẹ, hoặc đỡ đỡ người dùng nặng. Crédit mapping chi phí vào công việc thực tế - xem bảng theo endpoint trên trang giá.

Các phản hồi trên gói miễn phí chứa trường _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Điều này không chi phí gì cho chúng tôi, và cho người dùng miễn phí nó cung cấp một động lực nhỏ để nâng cấp. Trên gói Hobby+, nó có thể được tắt trong cài đặt khóa. Mẫu này được lấy từ Zapier và RevenueCat.

/rectification (chọn thời gian sinh nhật dựa trên các sự kiện cuộc sống qua tìm kiếm likelihood-grid) - tính toán tốn kém: một cuộc gọi kéo dài 10–60 giây và thực hiện hàng chục nghìn phép tính trung gian Swiss Ephemeris. Chúng tôi đã giới hạn nó trong gói Pro ($59 / tháng) và đặt một mức crédito cao vì việc lạm dụng sẽ đặtภาระ lên cơ sở hạ tầng chung cho mọi người.

Các endpoint /interpret/* hoạt động qua AI-gateway riêng của chúng tôi với tự động failover giữa một số mô hình. Chúng tôi không khóa bạn trong các prompt của chúng tôi - mỗi phản hồi có interpretación chứa các tính toán đầu ra, vì vậy bạn có thể tự triển khai LLM của riêng bạn nếu tiếng của chúng tôi không phù hợp với bạn. Các prompt đầy đủ và đầu ra được chúng tôi ghi vào bảng audit để tuân thủ B2B (lưu trữ 90 ngày).

• Gói Vedic: giai đoạn 3, sau những xác nhận đầu tiên về nhu cầu (xem trên)
• Webhook đạt ngưỡng: đã triển khai, nhưng UI còn thô; chúng tôi đang cải thiện
• Widget công khai (<script src="api.astroway.info/widget/natal.js">) - giai đoạn 7
• Plugin cho trang web Marketing chính: dự án riêng, được lập kế hoạch trong khuôn khổ ecosystem astroway.info

1. Đọc tài liệu nếu bạn muốn hiểu “tại sao”: api.astroway.info/overview
2. Khởi động nhanh trong 5 phút với mã: Khởi động nhanh API As-tro-logia
3. Giá cả, bao gồm bảng crédito theo endpoint: api.astroway.info/pricing
4. Đăng ký: miễn phí, không cần thẻ: api.astroway.info/dashboard/sign-up

Nếu bạn xây dựng gì trên API - hoặc tìm thấy lỗi, hoặc muốn một endpoint mà chúng tôi chưa có - hãy gửi tin cho chúng tôi. Chúng tôi thích hơn là nghe từ một trăm nhà phát triển đang yêu cầu gì đó, thay vì ra mắt tính năng mà không ai sử dụng.

Câu hỏi, yêu cầu, các trường hợp edge kỳ lạ: hello@astroway.info.

Roadmap công khai - PRODUCT-PLAN.md - những gì đã làm, những gì sẽ tới, những gì đã hoãn và tại sao.

Chào mừng bạn.