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, fitur kompatibilitas kencan, dan agen AI yang memiliki kemampuan untuk mempertimbangkan carta kelahiran.

Dalam artikel ini — apa yang sebenarnya ada di dalam API, keputusan tidak biasa apa yang kami ambil, apa yang kami tinggalkan di luar kurung, dan bagaimana kami sampai di sini. Tanpa basa-basi.

🕓 Catatan dari 2026-04-22, diperbarui 2026-05-09. Beberapa angka sudah ketinggalan zaman. Status terkini: 723 endpoint (bukan 87 pada saat peluncuran), 818 snapshot tes CI (bukan 183), MCP-server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk sekarang semua hidup di registri publik. Status terkini — di /faq dan changelog.

REST API berbasis Swiss Ephemeris (LGPL), dikompilasi ke dalam WASM dan diterapkan sebagai layanan Node.js — sekarang juga dengan interpretasi AI (rantai failover GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) di atas komputasi nyata. Mesin yang sama yang digunakan oleh ahli astrologi profesional selama 30+ tahun dalam Solar Fire, Kepler, Astro Gold, dan Janus — presisi hingga bagian kuintal detik, diverifikasi dengan ephemeris NASA JPL dan referensi swetest resmi dari Astrodienst (Astro.com).

Angka-angka:

• 723 endpoint — astrologi kelahiran barat, sinastria, transisi, progresi, direktori, pengembalian, harmonik, bintang tetap, titik arab, astrokartografi plus set lengkap Human Design
• 183 snapshot tes dalam 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 registri publik: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — API yang sama dalam tiga bahasa
• MCP-server: @astroway/mcp — menyajikan API sebagai alat untuk Claude, GPT, Cursor, dan agen LLM lainnya
• Tarif berbasis kredit: rencana gratis (10.000 kredit / bulan, tanpa kartu), berbayar — mulai dari $5 / bulan

Dokumentasi lengkap: api.astroway.info/docs/api/. Status terkini: api.astroway.info/status.

Tiga tahun yang lalu kami mulai membangun aplikasi astrologi konsumen. Lapisan komputasi terbukti menjadi bagian tersulit — jauh lebih sulit daripada UI atau konten. Layanan yang ada baik:

1. Memiliki cakupan yang dangkal (10–30 endpoint, sebagian besar hanya kelahiran)
2. Mahal dalam skala ($0,02–$0,10 per permintaan tanpa diskon grosir)
3. Menggunakan mesin tertutup, presisi yang tidak dapat diverifikasi
4. Berfokus pada astrologi Veda, sementara barat disajikan sebagai yang kedua

Jadi kami mem-vendor Swiss Ephemeris sendiri dan menulis lapisan komputasi kami sendiri — pertama untuk produk konsumen app.astroway.info, kemudian untuk situs pemasaran astroway.info, yang melayani ratusan ribu pengunjung per bulan.

Dalam tiga tahun kerja kode ini di produksi, kami sampai pada dua kesimpulan:

1. Mesin komputasi yang sama harus tersedia bagi pengembang lain — bukan karena mereka tidak dapat menulisnya sendiri, tetapi karena tumpukan perpustakaan + WASM + caching + CI pada presisi — ini setengah tahun kerja, yang tidak perlu diulangi oleh siapa pun.
2. Cakupan Human Design kami (12 endpoint — carta, jenis, otoritas, profil, gerbang, saluran, kontur, aktivasi planet, incarnation cross, definisi) — benar-benar unik. Tidak ada pesaing yang menawarkan tumpukan HD lengkap melalui API.

Inilah peluncuran.

Kami memiliki /nakshatras, /ashtakavarga, dan endpoint untuk carta pembagian, tetapi tidak ada Dasha, Panchang, Ashtakoota, KP. Alasannya: dalam astrologi Veda, ada perbedaan yang belum terselesaikan antara sekolah-sekolah (perang ayanamsha, perselisihan tentang kuspid KP, pilihan sekolah dasha). Bagian Veda yang dibuat terburu-buru hanya akan mendapat kritik.

Keputusan yang diambil: paket Veda — fase 3, setelah permintaan awal dikonfirmasi (lihat di atas)

Satu panggilan /chart biayanya sekitar 50 kali lebih sedikit komputasi daripada /forecast-calendar 365 hari. Harga datar per permintaan atau akan memotong pengguna ringan, atau mensubsidi pengguna berat. Kredit memetakan biaya ke pekerjaan nyata — lihat tabel pada endpoint di halaman harga.

Jawaban pada rencana gratis berisi bidang _footer:

{
  "data": { ... },
  "_footer": "Dipowered oleh astroway.api — dapatkan kunci Anda sendiri di api.astroway.info"
}

Kami tidak kehilangan apa-apa, dan pengguna gratis mendapatkan sedikit insentif untuk meningkatkan. Pada rencana Hobby+, dihilangkan di pengaturan kunci. Pola dipinjam dari Zapier dan RevenueCat.

/rectification (pencarian waktu kelahiran melalui likelihood-grid pencarian berdasarkan peristiwa hidup) — komputasi yang mahal: satu panggilan memakan waktu 10–60 detik dan melakukan puluhan ribu komputasi Swiss Ephemeris. Kami membatasinya pada rencana Pro ($59 / bulan) dan menetapkan harga kredit yang besar, karena penyalahgunaan akan memengaruhi infrastruktur bersama untuk semua orang.

Endpoint /interpret/* diarahkan melalui gerbang AI pribadi kami, yang berada di atas model terbaik di pasar (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) dengan failover otomatis. Kami tidak mengunci Anda dalam prompt kami — setiap jawaban dengan interpretasi berisi komputasi asli, sehingga Anda dapat meminta ulang dengan LLM Anda sendiri jika suara kami tidak sesuai dengan Anda. Prompt dan output lengkap kami log di tabel audit untuk kepatuhan B2B (penyimpanan 90 hari).

• Paket Veda — fase 3, setelah permintaan awal dikonfirmasi (lihat di atas)
• Webhook pada ambang batas — direalisasikan, tetapi UI masih kasar; sedang diperbarui
• Widget publik (<script src="api.astroway.info/widget/natal.js">) — fase 7
• Plugin untuk situs pemasaran utama — proyek terpisah, direncanakan dalam kerangka ekosistem astroway.info

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

Jika Anda membangun sesuatu di atas API — atau menemukan bug, atau menginginkan endpoint yang belum kami miliki — tulis kepada kami. Kami lebih suka mendengar seratus pengembang yang meminta sesuatu daripada meluncurkan fitur yang tidak digunakan oleh siapa pun.

Pertanyaan, permintaan, kasus tepi aneh: hello@astroway.info.

Roadmap publik — PRODUCT-PLAN.md — apa yang telah dilakukan, apa yang berikutnya, apa yang ditunda, dan mengapa.

Selamat datang.