FAQ answers

Umum

Apa itu AstroWay API?

API HTTP profesional untuk perhitungan astrologi. 771 endpoint berbasis Swiss Ephemeris: peta natal, sinastri, progresi, direksi, transit, Human Design, astrologi kartografi, retifikasi, interpretasi AI. Semua perhitungan dilakukan di server - tidak ada ketergantungan di sisi klien.

Untuk siapa API ini?

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

Seberapa akurat perhitungannya?

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

Bagaimana AstroWay dibandingkan dengan Astro.com atau Solar Fire?

Mesin Swiss Ephemeris yang identik - sama dengan yang ada di Solar Fire ($495 lisensi), Kepler ($995), Astro Gold ($29.99/bulan) dan Astrodienst (Astro.com). Diverifikasi terhadap NASA JPL ephemeris dan referensi swetest resmi dari Astrodienst. Drift sub-arcsecond (≤0.1″) pada posisi planet, ≤1 menit pada gerhana. Perbedaannya: AstroWay - REST API mulai $5/bulan alih-alih lisensi satu kali atau GUI desktop.

Sistem rumah apa 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. Kirimkan kode yang sesuai dalam parameter houseSystem.

Kredit dan pembayaran

Bagaimana sistem kredit bekerja?

Setiap endpoint memiliki biaya tetap dalam kredit (dari 10 hingga 500), tergantung pada kompleksitas perhitungan. Lookup sederhana - 10, peta natal - 20, sinastri - 50, retifikasi - 500. Tabel lengkap ada di halaman Tarif.

Apakah ada paket gratis?

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

Apa yang terjadi ketika kredit habis?

Pada Free - permintaan diblokir hingga bulan berikutnya (429 CREDITS_EXHAUSTED). Pada Indie/Starter/Pro/Business - overage diaktifkan: $5 / $3 / $2 per 10.000 kredit tambahan.

Apakah permintaan yang sama di-cache?

Ya. Input yang identik dalam 5 menit akan dikembalikan dari cache tanpa mengurangi kredit. Dikonfirmasi dengan header X-Cache: HIT.

Bisakah membeli kredit tanpa berlangganan?

Belum. Berlangganan memberikan anggaran yang dapat diprediksi dan rate limit yang lebih baik. Pay-as-you-go sedang direncanakan.

Teknis

SDK apa yang tersedia?

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

Kontrak API - REST + JSON standar, jadi semua klien HTTP dapat bekerja tanpa SDK. Koleksi Postman dan spesifikasi OpenAPI 3.1 tersedia secara publik.

Apakah ada mode sandbox?

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

Berapa rate limit?

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

Apakah zodiak sidereal didukung?

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

Apa itu endpoint Human Design?

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

Keamanan dan privasi

Apakah data permintaan disimpan?

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

Apakah API memenuhi persyaratan GDPR?

Ya. Data tidak disimpan. Untuk pengguna di UE: tidak ada pemrosesan PII, tidak ada profilasi, tidak ada cookie. API key terikat pada akun, bukan pada pengguna akhir.

Apakah interpretasi AI aman?

Endpoint AI (/interpret/*, /horoscope/*) memiliki safety guardrails bawaan: larangan saran medis, hukum, keuangan. Setiap jawaban menyertakan disclaimer. Jejak audit lengkap - 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 ada di halaman Kontak.

Apakah ada SLA?

Indie: 99% uptime. Starter dan Pro: 99,9% uptime. Business: 99,95% uptime. Enterprise: SLA khusus dengan jaminan keuangan.

Nama serupa

Apakah AstroWay API (astroway.info) terkait dengan langganan “Astroway” dari astroway.life?

Tidak. astroway.info dan api.astroway.info - adalah perusahaan terpisah, independen. Kami menyediakan API astrologi untuk pengembang (api.astroway.info), aplikasi untuk pengguna akhir (app.astroway.info) dan konsultasi astrolog. Kami tidak memiliki hubungan apa pun dengan langganan astrologi konsumen yang dipromosikan dan ditagih dengan nama “Astroway” melalui astroway.life (email dari no-reply@astroway.life, persona “Celeste”, pada laporan bank - “Astroway”). Operator langganan ini adalah TrafficLeader OÜ (Estonia, juga traffic-leader.com); billy terkait SKYREAD.PRO adalah ABCMobile OÜ (Estonia). Hanya kesamaan bunyi nama - ini perusahaan yang berbeda.

Saya ditagih “Astroway” - bagaimana membatalkan langganan dan mendapatkan pengembalian dana?

Jika Anda ditagih untuk langganan “Astroway” (email dari no-reply@astroway.life, pada laporan bank - “Astroway”), itu perusahaan lain, astroway.life, bukan kami. Kami tidak memiliki akses ke akun atau pembayaran Anda di layanan tersebut, sehingga tidak dapat membatalkannya atau mengembalikan dana. Cara menanganinya:

1. Balas langsung email dari no-reply@astroway.life dan gunakan tautan “unsubscribe / cancel” di footernya.
2. Jika tidak ada respons: hubungi bank atau penerbit kartu Anda (pembayaran di laporan - “Astroway”; merchant - TrafficLeader OÜ atau ABCMobile OÜ / SKYREAD.PRO, Estonia) dan minta blokir penagihan berulang atau ajukan chargeback.