# Aplikasi Astrologi

Membangun aplikasi Astro seperti Co-Star, Sanctuary, The Pattern, Chani, atau Costar Compat? AstroWay API menggantikan kebutuhan untuk melisensikan Solar Fire ($495) atau menulis mesin ephemeris kamu sendiri: {siteMeta.endpoints} endpoint (bagan kelahiran, sinastri, transit, Human Design, interpretasi AI), OpenAPI 3.1 untuk menghasilkan klien yang diketik (TS / Python SDK dalam roadmap), akurasi Swiss Ephemeris — mesin yang sama dengan Astrodienst dan Kepler.

## Arsitektur Khas

```
Pengguna (browser / seluler)
     ↓
Backend kamu (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Respons JSON → rendering di UI kamu
```

<Aside type="caution">
Jangan pernah menempatkan kunci API di kode frontend. Panggilan AstroWay API harus melalui backend atau fungsi server kamu (Next.js API routes, Vercel Functions, AWS Lambda).
</Aside>

## Endpoint Kunci untuk Aplikasi Astrologi

### MVP (Produk Minimum)

| Endpoint | Kredit | Untuk Apa |
|---|---|---|
| `/v1/chart` | 20 | Membuat bagan kelahiran |
| `/v1/synastry` | 50 | Kompatibilitas dua orang |
| `/v1/horoscope/daily` | 20 | Horoskop harian |

Tiga endpoint — dan kamu sudah memiliki produk yang berfungsi dengan bagan kelahiran, kompatibilitas, dan konten harian.

### Produk yang Diperluas

| Endpoint | Kredit | Untuk Apa |
|---|---|---|
| `/v1/transits` | 50 | Transit saat ini ke bagan kelahiran |
| `/v1/solar-return` | 50 | Solar Return (bagan tahunan) |
| `/v1/progressions` | 50 | Progresi sekunder |
| `/v1/interpret/natal` | 50 | Interpretasi bagan kelahiran AI |
| `/v1/transit-calendar` | 100 | Kalender peristiwa transit |
| `/v1/human-design` | 50 | Bagan HD |

### Fitur Premium

| Endpoint | Kredit | Untuk Apa |
|---|---|---|
| `/v1/rectification` | 500 | Rektifikasi waktu kelahiran |
| `/v1/acg` | 50 | Astrocartography (tempat terbaik untuk tinggal) |
| `/v1/forecast-calendar` | 100 | Heatmap perkiraan tahunan |
| `/v1/group-synastry` | 100 | Kompatibilitas grup |

## Estimasi Anggaran

### Skenario: 100 DAU (pengguna aktif harian)

Asumsikan pengguna rata-rata melakukan 3 tindakan per hari:

| Tindakan | Endpoint | Kredit | Permintaan/hari | Kredit/hari |
|---|---|---|---|---|
| Melihat bagan | `/v1/chart` | 20 | 100 | 2.000 |
| Horoskop harian | `/v1/horoscope/daily` | 20 | 100 | 2.000 |
| Kompatibilitas | `/v1/synastry` | 50 | 30 | 1.500 |
| **Total** | | | **230** | **5.500/hari** |

**~165.000 kredit/bulan** (5.500 × 30) → paket **Starter ($19/bulan, 200.000 kredit)** dengan cadangan 21%, atau **Indie ($5/bulan, 50.000)** dengan pembayaran overage ~$5 untuk 110K kredit tambahan.

### Skenario: MVP dengan 20 DAU

| Tindakan | Kredit/hari |
|---|---|
| 20 bagan | 400 |
| 20 horoskop | 400 |
| 5 sinastri | 250 |
| **Total** | **1.050/hari** |

**~31.500 kredit/bulan** → paket **Indie ($5/bulan, 50.000 kredit)**.

## Tips

- **Cache bagan kelahiran** — input tidak berubah (tanggal lahir tidak berubah), jadi hasilnya dapat di-cache selamanya di DB kamu
- **Cache horoskop harian** — horoskop harian sama untuk semua orang dengan tanda yang sama, hasilkan sekali dan distribusikan
- **Kunci Sandbox** (`aw_test_*`) — untuk pengembangan, tidak mengurangi kredit
- **Codegen dengan OpenAPI 3.1** — arahkan `/v1/openapi.json` ke `openapi-typescript` atau `openapi-python-client` dan dapatkan klien yang diketik (SDK siap pakai dalam roadmap)

<CardGrid>
  <LinkCard title="Mulai Cepat →" href="/getting-started/" description="Permintaan pertama dalam 5 menit" />
  <LinkCard title="API Bagan Kelahiran" href="/products/birth-chart-api/" description="Detail tentang bagan kelahiran" />
  <LinkCard title="Harga" href="/pricing/" description="Dari gratis hingga Enterprise" />
</CardGrid>