FAQ answers

Tổng quan

AstroWay API là gì?

API HTTP chuyên nghiệp dành cho các phép tính chiêm tinh. 723 endpoints dựa trên Swiss Ephemeris (WASM): biểu đồ natal, synastry, tiến triển, hướng dẫn, quá cảnh, Human Design, bản đồ thiên văn, rectification, giải thích bằng AI. Tất cả phép tính đều được thực hiện trên server — không có phụ thuộc nào trên phía client.

API này dành cho ai?

Dành cho các nhà phát triển xây dựng ứng dụng chiêm tinh (web/mobile), công ty AI bổ sung chức năng chiêm tinh, nhà chiêm tinh chuyên nghiệp sử dụng script, và các nhà nghiên cứu cần truy cập lập trình vào các phép tính.

Độ chính xác của phép tính là bao nhiêu?

Swiss Ephemeris đảm bảo độ chính xác vị trí hành tinh lên đến ±1 giây cung, điểm cusp nhà lên đến ±1 phút cung. Kết quả đã được xác minh so với Astrodienst (Astro.com), Solar Fire, Zet 9 và Kepler. Độ lệch dưới 1 giây cung so với NASA JPL ephemeris và NASA 5-Millennium Eclipse Catalog.

AstroWay so sánh thế nào với Astro.com hoặc Solar Fire?

Cùng sử dụng Swiss Ephemeris — giống như trong Solar Fire ($495 license), Kepler ($995), Astro Gold ($29.99/tháng) và Astrodienst (Astro.com). Đã được xác minh so với NASA JPL ephemeris và reference swetest chính thức từ Astrodienst. Độ lệch dưới 0.1 giây cung cho vị trí hành tinh, ≤1 phút cho nhật thực. Sự khác biệt: AstroWay là REST API từ $5/tháng thay vì license one-time hoặc GUI desktop.

Những hệ thống nhà nào được hỗ trợ?

15 hệ thống: Placidus (mặc định), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC và Equal từ MC. Truyền mã tương ứng vào tham số houseSystem.

Tín dụng & Thanh toán

Hệ thống tín dụng hoạt động như thế nào?

Mỗi endpoint có chi phí tín dụng cố định (từ 10 đến 500), tùy thuộc vào độ phức tạp của phép tính. Tra cứu đơn giản — 10, biểu đồ natal — 20, synastry — 50, rectification — 500. Bảng giá đầy đủ tại trang Giá.

Có gói miễn phí không?

Có. Gói Free cung cấp 10.000 tín dụng/tháng, 10 req/phút. Không cần nhập thẻ. Đủ để đánh giá sản phẩm và lập trình thử nghiệm.

Điều gì xảy ra khi hết tín dụng?

Ở Free — các yêu cầu bị chặn cho đến tháng tiếp theo (429 CREDITS_EXHAUSTED). Ở Indie/Starter/Pro/Business — kích hoạt overage: $5 / $3 / $2 cho mỗi 10.000 tín dụng bổ sung.

Những yêu cầu giống nhau có được cache không?

Có. Input giống nhau trong vòng 5 phút sẽ được trả về từ cache mà không trừ tín dụng. Được xác nhận bởi header X-Cache: HIT.

Có thể mua tín dụng mà không cần đăng ký không?

Chưa. Đăng ký cung cấp ngân sách dự đoán và giới hạn rate tốt hơn. Kế hoạch pay-as-you-go dự kiến sẽ có trong tương lai.

Kỹ thuật

Những SDK nào có sẵn?

• MCP server ✅ đã phát hành: npx -y @astroway/mcp — exposes tất cả 723+ endpoints dưới dạng công cụ cho Claude $1, Cursor, GPT và các AI agent tương thích MCP khác
• TypeScript SDK ✅ đã phát hành: npm install @astroway/sdk — types + autocomplete từ OpenAPI 3.1, retry + idempotency, lỗi theo phong cách Stainless
• Python SDK ✅ đã phát hành: pip install astroway — sync Astroway + async AsyncAstroway, dựa trên httpx, PEP 561 typed
• PHP SDK ✅ đã phát hành: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 dự kiến — đăng ký nhận thông báo qua email trên trang của từng SDK (/sdk/<language>/)

Hợp đồng API là REST + JSON tiêu chuẩn, vì vậy bất kỳ HTTP client nào cũng hoạt động mà không cần SDK. Postman collection và OpenAPI 3.1 spec đều có sẵn công khai.

Có chế độ sandbox không?

Có. Các khóa aw_test_* không trừ tín dụng và trả về kết quả giống nhau. Hoàn hảo cho phát triển và kiểm thử.

Giới hạn rate là bao nhiêu?

Phụ thuộc vào gói: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1.000 req/phút. Khi vượt quá — 429 kèm header Retry-After.

Có hỗ trợ cung hoàng đạo sidereal không?

Có. Truyền "zodiacType": "sidereal" và tùy chọn "ayanamsaId" (mặc định là Lahiri). Hoạt động với tất cả endpoints.

Những endpoint Human Design là gì?

12 endpoints để tính toán Human Design: type, strategy, authority, profile, definition, incarnation cross, channels, centers, Dream Rave, Hologenetic Profile, Penta (động lực nhóm), độ nhạy thời gian. Độ phủ Human Design sâu nhất trong số các API thương mại.

Bảo mật & Riêng tư

Dữ liệu về các yêu cầu có được lưu không?

API hoạt động stateless — dữ liệu về ngày/giờ/tọa độ sinh không được lưu sau khi xử lý yêu cầu. Chỉ có metadata được log: key_id, endpoint, timestamp, latency, tín dụng. Không có dữ liệu cá nhân.

API có tuân thủ GDPR không?

Có. Dữ liệu không được lưu. Đối với người dùng EU: không xử lý PII, không theo dõi, không cookies. API key được liên kết với tài khoản, không phải người dùng cuối.

Những giải thích bằng AI có an toàn không?

Các endpoint AI (/interpret/*, /horoscope/*) có cơ chế bảo vệ tích hợp: cấm tư vấn y tế, pháp lý, tài chính. Mỗi phản hồi đều bao gồm disclaimer. Toàn bộ nhật ký kiểm toán — cho compliance doanh nghiệp.

Hỗ trợ

Làm thế nào để nhận trợ giúp?

Phụ thuộc vào gói: Free — cộng đồng, Indie — email (48 giờ), Starter — email (24 giờ), Pro — email (4 giờ), Business — email + Slack (1 giờ), Enterprise — quản lý chuyên dụng trên Slack. Liên hệ tại trang Liên hệ.

Có SLA không?

Indie: 99% uptime. Starter và Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: SLA tùy chỉnh với bảo đảm tài chính.