Hướng dẫn sử dụng AstroWay API

Trung tâm tài liệu kỹ thuật AstroWay API. 761 điểm kết nối dựa trên Swiss Ephemeris, được trang bị OpenAPI, bộ sưu tập sẵn sàng cho Postman và Insomnia, SDK chính thức cho TypeScript, Python và PHP, MCP-server cho Claude/Cursor.

Reference

API Reference Bảng mục lục toàn bộ {siteMeta.endpoints} điểm kết nối: tham số, cấu trúc trả về, mã lỗi. Tạo ra từ OpenAPI spec trên mỗi bản phát hành.

OpenAPI specification Cấu trúc được đọc bởi máy. Chuyển vào Postman/Insomnia hoặc tạo ra SDK của bạn thông qua openapi-generator.

Postman collection Bộ sưu tập sẵn sàng để nhập vào Postman/Insomnia với các ví dụ cho mỗi điểm kết nối.

Chi phí cho mỗi điểm kết nối Chi phí cho mỗi điểm kết nối trong các đơn vị tín dụng - từ 0 đến 500 đơn vị tín dụng.

Start

Bắt đầu nhanh Đăng ký, nhận khóa, thực hiện yêu cầu đầu tiên trong 5 phút.

Đăng nhập X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT cho bảng điều khiển.

Điểm tín dụng và giới hạn Điểm tín dụng, giới hạn hàng tháng, giới hạn tốc độ cho mỗi kế hoạch.

Hỗ trợ ngôn ngữ 21 ngôn ngữ đang hoạt động. Lọc các nội dung văn bản thông qua `Accept-Language` (nội dung văn bản).

SDK và tích hợp

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

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

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

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

Kỹ thuật

Độ chính xác tính toán Swiss Ephemeris độ chính xác giây thứ 1. Kiểm tra CI-snapshot so với Catalog Eclipse của NASA.

Lỗi Danh sách mã lỗi, trạng thái HTTP và cấu trúc hộp lỗi.

Idempotence Header `Idempotency-Key` cho retry an toàn trên POST.

Định dạng phiên bản Cách chúng tôi nâng cấp phiên bản, làm thế nào để phá vỡ sự tương thích, cách đọc log phiên bản.

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.

Astronomy Vedic 354+ điểm kết nối cho Vedic - Vargas, dashas (8 hệ thống), Panchang, Shadbala, Yogas, Doshas.

Ví dụ mã Bộ sưu tập sẵn sàng cho các ví dụ về các bản đồ thiên văn, các bản đồ synastry, các bản đồ chuyển tiếp, Human Design, MCP.

Sử dụng trường hợp Kịch bản tích hợp cho các ứng dụng thiên văn, AI-agent và các nền tảng dating.