Meluncurkan AstroWay API: Tumpukan Penuh Perhitungan Astrologi dengan Akurasi Swiss Ephemeris

Hari ini kami mengumumkan AstroWay API - backend komputasi untuk pengembang yang membuat aplikasi astrologi, produk horoskop, fungsi kompatibilitas untuk kencan, dan agen AI yang harus memikirkan peta kelahiran.

Di artikel ini - apa sebenarnya di dalam API, keputusan tidak konvensional yang kami ambil, apa yang sengaja kami tinggalkan di balik kurung, dan bagaimana kami sampai di sini. Tanpa basa-basi.

🕓 Catatan dari 2026-04-22, diperbarui 2026-05-09. Beberapa angka sudah usang. Status terkini: 865 endpoint (bukan 87 pada saat peluncuran), 888 tes snapshot CI (bukan 183), MCP-server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk kini semua berada di public registries. Status terbaru ada di /faq dan changelog.

REST API berbasis Swiss Ephemeris - kini juga dengan interpretasi AI di atas perhitungan nyata. Mesin yang sama yang digunakan oleh astrolog profesional selama lebih dari 30 tahun di Solar Fire, Kepler, Astro Gold, dan Janus - akurasi hingga pecahan detik sudut, diverifikasi dengan efemeris NASA JPL dan referensi resmi swetest dari Astrodienst (Astro.com).

Angka:

• 865 endpoint: astrologi natal Barat, sinastri, transit, progresi, direksi, kembali, harmonik, bintang tetap, titik Arab, astrokartografi plus set lengkap Human Design
• 183 tes snapshot di CI melawan output nyata swetest CGI dan katalog gerhana NASA - dijalankan pada setiap PR
• p50 < 100 ms, p95 < 500 ms untuk endpoint komputasi tipikal
• MCP-server @astroway/mcp + tiga SDK di public registries: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - API yang sama dalam tiga bahasa
• MCP-server: @astroway/mcp - menyediakan API sebagai tool untuk Claude, GPT, Cursor, dan agen LLM lainnya
• Tarif berbasis Kredit: paket gratis (10.000 kredit / bulan, tanpa kartu), berbayar - mulai dari $5 / bulan

Referensi lengkap: api.astroway.info/docs/api/. Status live: api.astroway.info/status.

Tiga tahun yang lalu kami mulai membangun aplikasi astrologi konsumen. Lapisan komputasi ternyata bagian paling sulit - jauh lebih rumit daripada UI atau konten. Layanan yang ada atau:

1. Memiliki cakupan dangkal (10–30 endpoint, kebanyakan hanya natal)
2. Mahal pada skala ($0.02–$0.10 per permintaan tanpa diskon grosir)
3. Menggunakan mesin tertutup, akurasinya tidak dapat diverifikasi
4. Berfokus pada astrologi Veda, sementara Barat diperlakukan sebagai sekunder

Jadi kami mengvendor Swiss Ephemeris secara mandiri dan menulis lapisan komputasi kami sendiri - awalnya untuk produk konsumen app.astroway.info, kemudian untuk situs Marketing astroway.info, yang menghasilkan horoskop harian untuk ratusan ribu pengunjung per bulan.

Selama tiga tahun kode ini berjalan di produksi, kami sampai pada dua kesimpulan:

1. Mesin komputasi yang sama harus tersedia bagi pengembang lain: bukan karena mereka tidak dapat menulisnya sendiri, melainkan karena stack library + caching + CI untuk akurasi memakan setengah tahun kerja, yang tidak layak diulang oleh siapa pun.
2. Cakupan Human Design kami (12 endpoint: peta, tipe, otoritas, profil, gerbang, kanal, kontur, aktivasi planet, incarnation cross, definition) - benar-benar unik. Tidak ada kompetitor yang menawarkan stack HD lengkap melalui API.

Itulah peluncurannya.

Kami memiliki /nakshatras, /ashtakavarga dan endpoint untuk peta divisional, tetapi tidak ada Dasha, Panchang, Ashtakoota, KP. Alasannya: dalam astrologi Veda ada perbedaan yang belum diselesaikan antar sekolah (perang ayanamsa, perselisihan tentang cusp KP, pilihan sekolah dasha). Bagian Veda yang dibuat terburu‑buruan melawan Prokerala dan VedicAstroAPI hanya akan mendapat kritik.

Keputusan tetap: paket Veda - fase terpisah 3, setelah ada permintaan stabil untuk Barat dan ada waktu untuk divalidasi melawan Jagannatha Hora dan Parashara’s Light. Lebih baik tidak meluncurkan sama sekali daripada meluncurkan dengan buruk.

Satu panggilan /chart membutuhkan ~50 kali lebih sedikit komputasi dibandingkan /forecast-calendar 365‑hari. Harga datar per permintaan akan memotong pengguna ringan atau mensubsidi yang berat. Kredit memetakan biaya ke pekerjaan nyata - lihat tabel per endpoint di halaman tarif.

Respons pada paket gratis menyertakan field _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Tidak ada biaya bagi kami, dan memberi pengguna gratis sedikit dorongan untuk upgrade. Pada paket Hobby+ field ini dihapus di pengaturan kunci. Pola dipinjam dari Zapier dan RevenueCat.

/rectification (pemilihan waktu lahir berdasarkan peristiwa hidup melalui pencarian likelihood‑grid) - komputasi mahal: satu panggilan memakan 10–60 detik dan melakukan puluhan ribu perhitungan perantara Swiss Ephemeris. Kami membatasinya pada paket Pro ($59 / bulan) dan menetapkan harga kredit tinggi, karena penyalahgunaan akan membebani infrastruktur bersama untuk semua yang lain.

Endpoint /interpret/* beroperasi melalui AI‑gateway pribadi kami dengan failover otomatis di antara beberapa model. Kami tidak mengunci kamu dalam prompt kami – setiap respons dengan interpretasi menyertakan perhitungan mentah, jadi kamu dapat memprogram ulang dengan LLM milikmu jika suara kami tidak cocok. Prompt lengkap dan output kami log ke tabel audit untuk kepatuhan B2B (penyimpanan 90 hari).

• Paket Veda: fase 3, setelah konfirmasi permintaan pertama (lihat di atas)
• Webhook untuk pencapaian ambang: sudah diimplementasikan, tapi UI masih mentah; sedang diperbaiki
• Widget publik (<script src="api.astroway.info/widget/natal.js">) - fase 7
• Plugin untuk situs Marketing utama: proyek terpisah, direncanakan dalam ekosistem astroway.info

1. Baca dokumentasi jika ingin memahami “kenapa”: api.astroway.info/overview
2. Mulai cepat dalam 5 menit dengan kode: Astrology API Quick Start
3. Tarif, termasuk tabel kredit per endpoint: api.astroway.info/pricing
4. Daftar: gratis, tanpa kartu: api.astroway.info/dashboard/sign-up

Jika kamu membangun sesuatu di atas API – atau menemukan bug, atau menginginkan endpoint yang belum kami miliki – beri tahu kami. Lebih baik kami mendengar seratus pengembang yang meminta sesuatu daripada meluncurkan fitur yang tidak digunakan siapa‑siapa.

Pertanyaan, permintaan, edge case aneh: hello@astroway.info.

Roadmap publik – PRODUCT-PLAN.md – apa yang sudah selesai, apa selanjutnya, apa yang ditunda dan mengapa.

Selamat datang.