FAQ answers

Tổng quan

AstroWay API là gì?

API HTTP chuyên nghiệp cho các tính toán chiêm tinh. 771 endpoint trên nền Swiss Ephemeris: bản đồ sinh, synastry, tiến triển, directio, chuyển động, Human Design, astrokartography, rectification, AI-interpretations. Tất cả tính toán trên máy chủ - không có phụ thuộc nào ở phía client.

Dành cho ai API này?

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

Độ chính xác của các tính toán?

Swiss Ephemeris cung cấp độ chính xác vị trí hành tinh tới ±1 giây góc, cusp nhà tới ±1 phút góc. Kết quả đã được xác thực so với Astrodienst (Astro.com), Solar Fire, Zet 9 và Kepler. Độ trôi sub-arcsecond so với NASA JPL ephemeris và NASA 5-Millennium Eclipse Catalog.

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

Engine Swiss Ephemeris giống hệt - cùng một engine như trong Solar Fire ($495 license), Kepler ($995), Astro Gold ($29.99/tháng) và Astrodienst (Astro.com). Được xác thực so với NASA JPL ephemeris và tham chiếu swetest chính thức từ Astrodienst. Độ trôi sub-arcsecond (≤0.1″) trên vị trí hành tinh, ≤1 phút trên nhật thực. Khác biệt: AstroWay - REST API từ $5/tháng thay vì giấy phép một lần hoặc GUI desktop.

Các 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. Gửi mã tương ứng trong tham số houseSystem.

Credit và thanh toán

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

Mỗi endpoint có chi phí cố định bằng credit (từ 10 đến 500), tùy theo độ phức tạp của tính toán. Lookup đơn giản - 10, bản đồ sinh - 20, synastry - 50, rectification - 500. Bảng đầy đủ - trên trang Bảng giá.

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

Có. Gói Free cung cấp 10 000 credit/tháng, 10 req/min. Không cần nhập thẻ. Đủ để đánh giá sản phẩm và tạo prototype.

Sẽ xảy ra gì khi credit hết?

Với Free - các yêu cầu bị chặn cho đến tháng tiếp theo (429 CREDITS_EXHAUSTED). Với Indie/Starter/Pro/Business - bật overage: $5 / $3 / $2 cho mỗi 10 000 credit bổ sung.

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

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

Có thể mua credit mà không có gói đăng ký không?

Hiện chưa. Đăng ký cung cấp ngân sách dự đoán được và rate limit tốt hơn. Pay-as-you-go đang được lên kế hoạch.

Kỹ thuật

SDK nào có sẵn?

• MCP server ✅ đã hoàn thiện: npx -y @astroway/mcp: expose tất cả 771+ endpoint như công cụ cho Claude Desktop, Cursor, GPT và các AI-agent tương thích MCP khác
• TypeScript SDK ✅ đã hoàn thiện: npm install @astroway/sdk: types + autocomplete từ OpenAPI 3.1, retry + idempotency, lỗi kiểu Stainless
• Python SDK ✅ đã hoàn thiện: pip install astroway: sync Astroway + async AsyncAstroway, dựa trên httpx, typed theo PEP 561
• PHP SDK ✅ đã hoàn thiện: 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 mỗi SDK (/sdk/<language>/)

Hợp đồng API - 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. Bộ sưu tập Postman và spec OpenAPI 3.1 có sẵn công khai.

Có chế độ sandbox không?

Có. Các key aw_test_* không trừ credit và trả về cùng kết quả. Lý tưởng cho phát triển và kiểm thử.

Rate limit là bao nhiêu?

Phụ thuộc vào gói: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1 000 req/min. Khi vượt quá - 429 với header Retry-After.

Có hỗ trợ zodiac sidereal không?

Có. Gửi "zodiacType": "sidereal" và tùy chọn "ayanamsaId" (mặc định - Lahiri). Hoạt động với mọi endpoint.

Human Design endpoint là gì?

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

Bảo mật và riêng tư

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

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

API có đáp ứng yêu cầu 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 profiling, không cookies. API key gắn với tài khoản, không phải người dùng cuối.

Các AI-interpretations có an toàn không?

AI-endpoint (/interpret/*, /horoscope/*) có các safety guardrails tích hợp: cấm tư vấn y tế, pháp lý, tài chính. Mỗi phản hồi bao gồm disclaimer. Toàn bộ audit trail - cho enterprise compliance.

Hỗ trợ

Làm sao để nhận trợ giúp?

Phụ thuộc vào gói: Free - community, Indie - email (48 giờ), Starter - email (24 giờ), Pro - email (4 giờ), Business - email + Slack (1 giờ), Enterprise - quản lý riêng trên Slack. Liên hệ - trên 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.

Tên tương tự

AstroWay API (astroway.info) có liên quan đến gói đăng ký “Astroway” của astroway.life không?

Không. astroway.info và api.astroway.info - là một công ty riêng biệt, độc lập. Chúng tôi cung cấp API chiêm tinh cho nhà phát triển (api.astroway.info), ứng dụng cho người dùng cuối (app.astroway.info) và tư vấn chiêm tinh. Chúng tôi không có bất kỳ mối quan hệ nào với gói đăng ký chiêm tinh dành cho người tiêu dùng, được quảng cáo và tính phí dưới tên “Astroway” qua astroway.life (email từ no-reply@astroway.life, nhân vật “Celeste”, trong sao kê ngân hàng - “Astroway”). Nhà điều hành gói này - TrafficLeader OÜ (Estonia, cũng traffic-leader.com); bên thanh toán phụ SKYREAD.PRO - là ABCMobile OÜ (Estonia). Chỉ trùng tên âm thanh - đây là các công ty khác nhau.

Tôi bị tính phí “Astroway” - làm sao hủy đăng ký và nhận lại tiền?

Nếu bạn bị tính phí cho gói “Astroway” (email từ no-reply@astroway.life, trong sao kê ngân hàng - “Astroway”), đó là công ty khác, astroway.life, không phải chúng tôi. Chúng tôi không có quyền truy cập vào tài khoản hoặc thanh toán của bạn trên dịch vụ này, vì vậy không thể hủy hoặc hoàn tiền. Cách thực hiện:

1. Trả lời trực tiếp email từ no-reply@astroway.life và sử dụng liên kết “unsubscribe / cancel” trong phần footer.
2. Nếu không phản hồi: liên hệ ngân hàng của bạn hoặc tổ chức phát hành thẻ (giao dịch trong sao kê - “Astroway”; merchant - TrafficLeader OÜ hoặc ABCMobile OÜ / SKYREAD.PRO, Estonia) và yêu cầu chặn các lần tính phí tiếp theo hoặc thực hiện chargeback.