Tài liệu AstroWay API

Trung tâm tài liệu kỹ thuật của AstroWay API. 865 endpoint dựa trên Swiss Ephemeris, OpenAPI spec cho máy đọc, bộ collection sẵn dùng cho Postman và Insomnia, SDK chính thức cho TypeScript, Python và PHP, MCP server cho Claude/Cursor.

Reference

API Reference Danh mục đầy đủ 865 endpoint: tham số, schema của response, mã lỗi. Được tạo từ OpenAPI spec ở mỗi bản phát hành.

OpenAPI specification Spec cho máy đọc. Import vào Postman/Insomnia hoặc tự tạo SDK bằng openapi-generator.

Postman collection Collection sẵn sàng để import, có ví dụ cho từng endpoint.

Per-endpoint cost Chi phí tính bằng credit cho từng endpoint, từ 0 đến 500 credit.

Bắt đầu

Bắt đầu nhanh Đăng ký, lấy key và thực hiện lần gọi đầu tiên trong 5 phút.

Xác thực X-Api-Key và Bearer, live (aw_live_*) và sandbox (aw_test_*), JWT cho dashboard.

Credit và giới hạn Gộp credit, hạn mức theo tháng, rate limit theo gói.

Hỗ trợ ngôn ngữ 21 ngôn ngữ đang hoạt động. Bản địa hóa response qua `Accept-Language` (nội dung văn bản).

SDK và tích hợp

TypeScript SDK Package chính thức `@astroway/sdk` trên npm. ESM, Node 20+, tương thích trình duyệt.

Python SDK Package chính thức `astroway` trên PyPI. Client đồng bộ và bất đồng bộ, Python 3.9+.

PHP SDK Package chính thức `astroway/sdk` trên Packagist. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp`: server Model Context Protocol cho Claude Desktop, Cursor và các AI agent khác.

Kỹ thuật

Độ chính xác tính toán Độ chính xác đến giây cung của Swiss Ephemeris. Test snapshot trong CI đối chiếu với NASA Eclipse Catalog.

Lỗi Danh sách error code, mã trạng thái HTTP và cấu trúc error envelope.

Idempotency Header `Idempotency-Key` để retry POST an toàn.

Quản lý phiên bản Cách chúng tôi tăng phiên bản, điều gì phá vỡ tương thích, cách đọc changelog.

Kịch bản và ví dụ

Tổng quan sản phẩm Bốn nhóm sản phẩm: Birth Chart, Human Design, Synastry, Horoscope.

Chiêm tinh Vệ Đà Hơn 354 endpoint cho Vedic: Vargas, dashas (8 hệ thống), Panchang, Shadbala, Yogas, Doshas.

Ví dụ code Snippet sẵn dùng cho bản đồ sao cá nhân, synastry, transit, Human Design, MCP.

Use cases Kịch bản tích hợp cho ứng dụng chiêm tinh, AI agent và nền tảng hẹn hò.