# Tổng quan

**AstroWay API** — dịch vụ backend chuyên nghiệp dành cho tính toán chiêm tinh.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoints dựa trên Swiss Ephemeris (WASM), bao gồm các kỹ thuật không có ở bất kỳ đối thủ nào: hài hòa, bản đồ rồng, CCG, sectores của Gauquelin, Human Design đầy đủ, hiệu chỉnh thời gian sinh.

## Đối tượng phù hợp

1. **Nhà phát triển ứng dụng chiêm tinh** (web, mobile) cần các phép tính chính xác và đa dạng mà không cần cơ sở hạ tầng tính toán riêng.
2. **Công ty AI** tích hợp chức năng chiêm tinh — có sẵn MCP server dành cho Claude, ChatGPT và các tác nhân khác.
3. **Chuyên gia chiêm tinh chuyên nghiệp** xây dựng công cụ hoặc script riêng cho khách hàng.
4. **Nhà nghiên cứu** cần truy cập lập trình để thực hiện nghiên cứu thống kê.
5. **Nền tảng nội dung** bổ sung tính năng chiêm tinh vào sản phẩm hiện có.

## Đối tượng **không** phù hợp

- Các tiện ích "cung hoàng đạo hôm nay" đơn giản không có kiểm soát — API cung cấp các chức năng (`/interpret/*`, `/horoscope/*`), nhưng được thiết kế như API dành cho nhà phát triển, không phải dưới dạng tiện ích hoàn chỉnh.
- Chuyên ngành chiêm tinh Vệ Đà là chính — đối với các dự án Vedic-first (hệ thống Dasha, Panchang, KP), Prokerala và VedicAstroAPI mạnh hơn. Đối với chiêm tinh phương Tây + Human Design + các kỹ thuật hiếm (hiệu chỉnh, hài hòa, CCG), AstroWay vượt trội hơn. Xem thêm /compare/.
- Tarot/chiêm tinh số — chỉ tập trung vào chiêm tinh và Human Design. I-Ching có sẵn dưới dạng endpoint bổ sung.

## Điều gì khiến AstroWay trở nên độc đáo

### 1. Các kỹ thuật hiếm có dưới dạng API

| Kỹ thuật | Mục đích |
|---|---|
| **Bản đồ hài hòa** (H2–H180) | Chiêm tinh nghiên cứu (phương pháp của John Addey) |
| **Bản đồ rồng** | Chiêm tinh nghiệp chướng/tâm linh |
| **CCG (Cyclo-Carto-Graphy)** | Bản đồ tiến triển thiên thể — kỹ thuật cao cấp của Jim Lewis |
| **Secteurs của Gauquelin** | Chiêm tinh thống kê, sử dụng trong học thuật |
| **Tiến triển cấp ba** | Loại tiến triển thứ ba — hiếm nhưng được đánh giá cao |
| **Antiscions / Contra-antiscions** | Kỹ thuật cổ điển Hy Lạp-La Mã — phục hồi các trường phái truyền thống |
| **Khía cạnh song song** | Khía cạnh theo decan — thực hành nâng cao |
| **Hiệu chỉnh thông qua API** | Hiệu chỉnh thời gian sinh — giá trị cực cao |
| **Chu kỳ hành tinh** (giao hội) | Chiêm tinh Mundane — sự kiện toàn cầu |
| **Chỉ số chu kỳ của Barbault** | Chiêm tinh Mundane |
| **Cực tiểu Algol** | Thời điểm của các ngôi sao cố định — chiêm tinh electional |
| **Đường không gian địa phương** | Hướng dẫn chiêm tinh giống phong thủy |
| **Chuỗi dispositor** | Đồ thị điều khiển — kỹ thuật cổ điển |
| **Almutens figuris** | Kỹ thuật trung cổ — phục hồi truyền thống |

### 2. Độ chính xác của Swiss Ephemeris — cùng một engine được sử dụng trong Solar Fire ($495), Kepler ($995), Astro Gold

Cùng Swiss Ephemeris (LGPL) được các chuyên gia chiêm tinh chuyên nghiệp sử dụng trong Solar Fire, Kepler, Astro Gold và Janus trong hơn 30 năm — nhưng dưới dạng bản build WASM và REST API, không có phí trung gian. Độ chính xác:

- Vị trí hành tinh: ±1 giây cung so với NASA JPL ephemeris
- Điểm nhà: ±1 phút cung
- Kiểm chứng so với Zet 9, Solar Fire (ephemeris độc quyền), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — sai lệch nằm trong phạm vi sai số phương pháp (≤0.1″).

### 3. {siteMeta.endpoints} endpoints — bao phủ sâu rộng các kỹ thuật phương Tây

{siteMeta.westernCount} endpoints tính toán chiêm tinh phương Tây (4 trường phái: Hy Lạp-La Mã, tâm lý hiện đại, tiến hóa, космобиология) + diễn giải AI + Human Design đầy đủ. Tập trung chuyên sâu thay vì phân tán qua nhiều lĩnh vực.

## Kiến trúc

```
Ứng dụng của bạn
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Tính toán và trả về JSON
```

- Tất cả phép tính được thực hiện **trên server** — không có blob WASM trên frontend ứng dụng của bạn, không có vấn đề cấp phép Swiss Ephemeris.
- Trạng thái không được lưu trên server — mỗi request là độc lập. Không rò rỉ dữ liệu khách hàng.
- API keys được liên kết với gói dịch vụ, giới hạn rate limit và hạn mức tín dụng hàng ngày. Giám sát thông qua dashboard.

## Tiếp theo

- [Bắt đầu nhanh](/getting-started/) — thực hiện request đầu tiên trong 5 phút
- [Xác thực](/authentication/) — cách lấy và lưu trữ API key
- [Tín dụng & giới hạn](/rate-limits-credits/) — cách hoạt động của hệ thống thanh toán
- [Tài liệu API](/docs/api/) — tất cả endpoints với playground tương tác