FAQ answers

Umum

Apa itu AstroWay API?

API HTTP profesional untuk perhitungan astrologi. 714 endpoint berbasis Swiss Ephemeris (WASM): peta natal, synastry, progresi, direktur, transit, Human Design, astrokartografi, rectifikasi, dan interpretasi AI. Semua perhitungan dilakukan di server — tidak ada dependensi di sisi klien.

Untuk siapa API ini?

Untuk pengembang yang membangun aplikasi astrologi (web/mobile), perusahaan AI yang menambahkan fitur astrologi, astrolog profesional dengan skrip, serta peneliti yang membutuhkan akses terprogram ke perhitungan.

Seberapa akurat perhitungannya?

Swiss Ephemeris menjamin akurasi posisi planet hingga ±1 detik busur, dan cusp rumah hingga ±1 menit busur. Hasil telah diverifikasi terhadap Astrodienst (Astro.com), Solar Fire, Zet 9, dan Kepler. Deviasi sub-arcsecond dibandingkan dengan ephemeris NASA JPL dan NASA 5-Millennium Eclipse Catalog.

Bagaimana AstroWay dibandingkan dengan Astro.com atau Solar Fire?

Menggunakan mesin Swiss Ephemeris yang sama — sama dengan yang digunakan Solar Fire ($495 lisensi), Kepler ($995), Astro Gold ($29.99/bulan), dan Astrodienst (Astro.com). Telah divalidasi terhadap ephemeris NASA JPL dan referensi swetest resmi dari Astrodienst. Deviasi sub-arcsecond (≤0.1″) pada posisi planet, ≤1 menit pada peristiwa gerhana. Perbedaannya: AstroWay adalah REST API dengan harga mulai dari $5/bulan, bukan lisensi satu kali atau GUI desktop.

Sistem rumah apa saja yang didukung?

15 sistem: Placidus (default), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC, dan Equal dari MC. Kirim kode yang sesuai melalui parameter houseSystem.

Kredit & Pembayaran

Bagaimana sistem kredit bekerja?

Setiap endpoint memiliki biaya tetap dalam kredit (antara 10 hingga 500), tergantung pada kompleksitas perhitungan. Lookup sederhana = 10, peta natal = 20, synastry = 50, rectifikasi = 500. Tabel lengkap tersedia di halaman Harga.

Apakah ada paket gratis?

Ya. Paket Free memberikan 10.000 kredit/bulan, 10 req/menit. Tanpa memerlukan kartu kredit. Cukup untuk mengevaluasi produk dan prototipe.

Apa yang terjadi jika kredit habis?

Pada paket Free, permintaan akan diblokir hingga bulan berikutnya (429 CREDITS_EXHAUSTED). Pada paket Indie/Starter/Pro/Business, akan dikenakan biaya tambahan: $5/$3/$2 per 10.000 kredit tambahan.

Apakah permintaan yang sama di-cache?

Ya. Input yang identik dalam waktu 5 menit akan dikembalikan dari cache tanpa pemotongan kredit. Konfirmasi melalui header X-Cache: HIT.

Bisakah saya membeli kredit tanpa berlangganan?

Belum. Langganan memberikan anggaran yang dapat diprediksi dan batas rate yang lebih baik. Rencana pay-as-you-go sedang direncanakan.

Teknis

SDK apa saja yang tersedia?

• Server MCP ✅ sudah dirilis: npx -y @astroway/mcp — mengekspos semua 714+ endpoint sebagai alat untuk Claude $1, Cursor, GPT, dan agen AI MCP lainnya
• SDK TypeScript ✅ sudah dirilis: npm install @astroway/sdk — tipe + autocomplete dari OpenAPI 3.1, retry + idempotency, error gaya Stainless
• SDK Python ✅ sudah dirilis: pip install astroway — sync Astroway + async AsyncAstroway, berbasis httpx, PEP 561 typed
• SDK PHP ✅ sudah dirilis: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, middleware retry
• Go / Ruby / Rust 📋 direncanakan — berlangganan notifikasi melalui email di halaman setiap SDK (/sdk/<language>/)

Kontrak API adalah REST + JSON standar, sehingga klien HTTP apa pun dapat digunakan tanpa SDK. Koleksi Postman dan spesifikasi OpenAPI 3.1 tersedia secara publik.

Apakah ada mode sandbox?

Ya. Kunci aw_test_* tidak memotong kredit dan mengembalikan hasil yang sama. Ideal untuk pengembangan dan pengujian.

Berapa batas rate-nya?

Tergantung paket: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1.000 req/menit. Jika melebihi, akan dikembalikan 429 dengan header Retry-After.

Apakah zodiak sideral didukung?

Ya. Kirim "zodiacType": "sidereal" dan opsional "ayanamsaId" (default — Lahiri). Berfungsi dengan semua endpoint.

Apa itu endpoint Human Design?

12 endpoint untuk menghitung Human Design: tipe, strategi, otoritas, profil, definisi, salib inkarnasi, kanal, pusat, Dream Rave, Hologenetic Profile, Penta (dinamika kelompok), dan sensitivitas temporal. Cakupan HD terdalam di antara API komersial.

Keamanan & Privasi

Apakah data permintaan disimpan?

API beroperasi dalam mode stateless — data tanggal/waktu/koordinat kelahiran tidak disimpan setelah permintaan diproses. Hanya metadata yang dicatat: key_id, endpoint, timestamp, latency, kredit. Tidak ada data pribadi.

Apakah API ini mematuhi GDPR?

Ya. Data tidak disimpan. Untuk pengguna dari UE: tidak ada pemrosesan PII, tidak ada pelacakan, tidak ada cookies. Kunci API terikat ke akun, bukan ke pengguna akhir.

Apakah interpretasi AI aman?

Endpoint AI (/interpret/*, /horoscope/*) memiliki guardrails bawaan: larangan saran medis, hukum, atau keuangan. Setiap respons menyertakan disclaimer. Jejak audit lengkap tersedia untuk kepatuhan enterprise.

Dukungan

Bagaimana cara mendapatkan bantuan?

Tergantung paket: Free — komunitas, Indie — email (48 jam), Starter — email (24 jam), Pro — email (4 jam), Business — email + Slack (1 jam), Enterprise — manajer khusus di Slack. Kontak tersedia di halaman Kontak.

Apakah ada SLA?

Indie: 99% uptime. Starter dan Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: SLA khusus dengan jaminan finansial.