Ghi chú kỹ thuật.
Về độ chính xác của ephemeris, kiến trúc tính toán, giao thức MCP và những chi tiết nhỏ nhặt không nằm trong docs.
Tài liệu được tạo cho AI agents, không chỉ cho con người
Tài liệu truyền thống được thiết kế cho mắt người: HTML đẹp, highlight code, navigation. Nhưng một nửa lưu lượng tới docs hiện là các agents và assistants, cần plain-text thay vì render. Chúng tôi đã thêm: bản sao .md cho mỗi trang, llms.txt, đặc tả máy đọc được, dropdown "mở trong ChatGPT / Claude" và inline try-it.
Đọc →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.
Đọc →MCP typed output: why 600+ tools have outputSchema
Most MCP servers return untyped JSON to the agent - the model has to guess the response format. We publish strict outputSchema for 600+ tools. We analyze how this works, what bug this opened in strict-mode clients and how we fixed it through open schemas.
Đọc →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.
Đọc →Cách chúng tôi kiểm soát độ chính xác: CI đối chiếu với swetest và NASA
Độ chính xác của một astro API rất dễ xuống cấp chỉ sau một lần refactor ephemeris. Chúng tôi phân tích cơ chế bảo vệ: một lõi Swiss Ephemeris chung cho ứng dụng và API, hàng trăm snapshot đóng băng trên các bản đồ sao chuẩn, và đối chiếu ba chiều mỗi PR với swetest CGI, Kerykeion, Prokerala và danh mục nhật nguyệt thực của NASA.
Đọc →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.
Đọc →Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
Đọc →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.
Đọc →