# API Overview

Base host: `https://astro.quizzman.com`  
Service: PM2 `qm-astro-serve` (Rust).

## Endpoints

| Method | Path | Purpose |
| --- | --- | --- |
| `GET` | `/health` | Liveness JSON |
| `GET` | `/viewer/sky` | Full sky frame (stars, planets, grids data) |
| `GET` | `/astro/day-sky` | Local civil day almanac |
| `GET` | `/v1/zodiac-support/*` | Zodiac / angles helpers |

## Sample calls

```bash
curl -s 'https://astro.quizzman.com/health'

curl -s 'https://astro.quizzman.com/viewer/sky?jd=2460000.5&lat=10.82&lon=106.63&magLimit=4&center=earth' | head -c 400

curl -s 'https://astro.quizzman.com/astro/day-sky?date=2026-07-27&timezone=VN&longitude=106.63' | head -c 400
```

## Next

- [Viewer Sky API](/guide/VIEWER_SKY_API.md)  
- [Day Sky API](/guide/DAY_SKY_API.md)  
- [Zodiac Support API](/guide/ZODIAC_SUPPORT_API.md)