Peta katalog: bagaimana 700+ endpoint AstroWay disusun

Katalog AstroWay sudah memiliki 758 endpoint dalam 57 grup. Pada skala sebesar ini, pertanyaan utama integrator bukanlah “apakah cakupannya cukup”, melainkan “bagaimana agar tidak tersesat”. Artikel ini adalah peta: bagaimana katalog dibagi menjadi domain dan cara menemukan yang kamu butuhkan dalam satu menit.

Terlepas dari domainnya, setiap endpoint perhitungan memiliki bentuk yang sama:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Body-nya adalah JSON dengan data kelahiran (tanggal, waktu, koordinat) atau parameter spesifik teknik. Responsnya selalu { "ok": true, "data": {...} } atau { "ok": false, "error": {...} }. Tidak ada GraphQL, tidak ada auth-flow terpisah per domain: satu kunci di header X-Api-Key, satu format respons.

Ini berarti wrapper yang kamu tulis untuk natal chart juga cocok untuk BaZi dan rune – hanya path dan skema body yang berubah.

Katalog dikelompokkan ke dalam domain-domain besar. Berikut adalah peta dengan penghitung aktual (angka diambil dari manifes pada setiap build, jadi di sini selalu terkini):

Sisanya adalah interpretasi AI, horoskop, endpoint referensi (tanda, planet, aspek) dan sistem (health, usage, openapi).

174 endpoint Veda - ini lebih banyak dari seluruh bagian Barat. Alasannya sederhana: tradisi Veda lebih terformalisasi. Di mana astrologi Barat memiliki satu set rumah, Veda memiliki 16 divisional-chart (varga), beberapa sistem dasha, puluhan yogas dengan aturan yang jelas. Masing-masing ini adalah endpoint terpisah dengan hasil yang deterministik.

Jika kamu membangun untuk pasar India, ini adalah inti produk, bukan tambahan.

Terlepas dari eksotisme tekniknya, posisi planet dihitung oleh satu inti pada Swiss Ephemeris (WASM). Inti yang sama berfungsi di browser aplikasi kami dan di server API - satu basis kode, tanpa perbedaan. Endpoint perhitungan dicakup oleh 873 snapshot-test, yang pada setiap PR diverifikasi dengan sumber referensi. Lebih detail tentang ini - dalam artikel terpisah tentang akurasi CI.

Tiga cara, dari yang tercepat:

1. Referensi OpenAPI - /docs/api/ dihasilkan langsung dari spesifikasi produksi openapi.json. Grup di sidebar = domain di atas. Setiap endpoint memiliki skema body, contoh, dan tombol ‘coba’.
2. Katalog MCP - jika kamu menggunakan Claude atau Cursor, seluruh katalog tersedia sebagai seperangkat alat melalui mcp.astroway.info. Agen akan menemukan endpoint yang kamu butuhkan berdasarkan deskripsi.
3. Pencarian berdasarkan spesifikasi - curl https://api.astroway.info/v1/openapi.json mengembalikan kontrak yang dapat dibaca mesin secara lengkap. Nyaman untuk pembuatan kode klien kamu sendiri.

Kunci di dashboard/sign-up memberikan 10.000 kredit per bulan - cukup untuk menjelajahi puluhan domain dan memahami mana yang cocok untukmu. Katalog tidak perlu dipelajari seluruhnya: ambil domainmu, dan sisanya akan menunggu saat dibutuhkan.