How we build the API.
Internals, postmortems, and design decisions. Everything we wish someone had written down before we had to figure it out the hard way.
Số học trong API: 5 hệ thống tính toán qua một route
Hầu hết các API hoặc không có số học, hoặc chỉ cung cấp một hệ thống Pythagorean. Chúng tôi có 5 hệ thống đầy đủ (Pythagorean, Chaldean, hai hệ Kabbalah, Vedic) mỗi hệ 10 tính toán, qua một route có tham số. Thêm Ma trận Số Phận cho 22 arcana.
Bản đồ danh mục: cách cấu trúc 700+ endpoint AstroWay
API đã tăng lên hơn 700 endpoint trong 57 nhóm - từ bản đồ sinh nhật đến BaZi, geomancy và render SVG. Phân tích cách danh mục được chia thành các miền, với một mẫu duy nhất cho tất cả các lời gọi và cách nhanh chóng tìm endpoint cần thiết.
Ba SDK chính thức: TypeScript, Python, PHP thay vì curl thô
HTTP thô hoạt động, nhưng client có kiểu dữ liệu tiết kiệm giờ: tự động hoàn thiện đường dẫn, kiểu yêu cầu và phản hồi, retry tích hợp cho 408/409/429/5xx và Stainless-style hệ thống lỗi. Xem xét ba SDK chính thức - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - và cách chúng được tạo từ một OpenAPI contract.
Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
Natal Chart API in PHP: SDK + Laravel Example
Compute a natal chart in PHP with the AstroWay SDK - plain PHP and a Laravel facade - without compiling a Swiss Ephemeris extension.
Natal Chart API in Python: 3 Examples with the AstroWay SDK
How to compute a natal chart in Python via API - install, first request, transits and synastry - with working code and how it compares to pyswisseph and kerykeion.
Natal Chart API in TypeScript: SDK + React Example
Compute a natal chart in TypeScript with the AstroWay SDK - typed responses, a React component, and where it beats a local ephemeris library.
X-Cache header: trạng thái cache có thể nhìn thấy để tối ưu hoá tích hợp của khách hàng
Mỗi response API hiện nay mang X-Cache: MISS | HIT | BYPASS - khách hàng ngay lập tức thấy liệu yêu cầu được tính toán từ đầu hay được lấy từ cache. Điều này mở cột cache hit % trong /dashboard/usage và cho phép tối ưu hoá tích hợp mà không cần đoán.
Reports V2: một endpoint thay vì mười hai - `/v1/reports/generate`
Thay vì 12 type-specific route /reports/natal, /reports/synastry, … - một endpoint thống nhất POST /v1/reports/generate với trường report_type. SDK-consumers nhận một phương thức thay vì mười hai; MCP-catalog giảm từ 12 công cụ xuống còn một.
Chiêm tinh Vedic qua API: từ Parashara đến Lal Kitab trong 354 endpoint
AstroWay hiện có mức bao phủ Vedic đầy đủ nhất trong các API thương mại: 10 hệ thống dasha, 16 varga, Panchang, Lal Kitab đầy đủ + KP + Jaimini. Cách nó hoạt động và khi nào chọn kỹ thuật nào.
White-label PDF không cần WordPress: branding inline qua một trường
Trường whitelabel trong các schema của tất cả 12 endpoint /v1/reports/* hiện chấp nhận không chỉ boolean (đọc cấu hình DB), mà còn một đối tượng inline có 15 trường. Điều này loại bỏ sự phụ thuộc vào người dùng WordPress - bất kỳ API SaaS nào cũng có thể branding PDF ngay lập tức, không cần trang admin riêng.
Hướng dẫn xây dựng ứng dụng chiêm tinh: hướng dẫn toàn diện cho nhà phát triển
Hướng dẫn từng bước để tạo ứng dụng chiêm tinh từ đầu - chọn API, kiến trúc, bản đồ sao đầu tiên, thêm synastry và chuyển động, triển khai.
Khởi động nhanh API chiêm tinh: TypeScript và Python trong 5 phút
Cài đặt SDK, nhận API-key, thực hiện yêu cầu đầu tiên về bản đồ sao. 5 phút - và bạn có JSON hoạt động (TypeScript và Python).
API Rectification: sửa thời gian sinh cho nhà phát triển
Rectification là quá trình sửa thời gian sinh không xác định hoặc không chính xác dựa trên sự kiện cuộc sống. Trong bài đăng này - cách tự động hóa nó thông qua API bằng phương pháp thuật toán và Trutine of Hermes.
Chính Swiss Ephemeris giống như trong Solar Fire - chỉ trong 4 dòng code.
Khóa API miễn phí không cần thẻ. 5.000 lượt gọi/tháng trước lần thanh toán đầu tiên.