FAQ answers

Genel

AstroWay API nedir?

Profesyonel HTTP API, astrolojik hesaplamalar için. Swiss Ephemeris (WASM) tabanlı 714 endpoint: doğum haritaları, sinastri, progresyonlar, direktifler, transitler, Human Design, astrokarografya, rectifikasyon, AI yorumları. Tüm hesaplamalar sunucuda gerçekleştirilir — istemci tarafında bağımlılık yok.

Bu API kimler için?

Astrolojik uygulamalar (web/mobil) geliştiren geliştiriciler, astrolojik özellikler ekleyen AI şirketleri, komut dosyalarıyla çalışan profesyonel astrologlar ve hesaplamalara programatik erişim ihtiyacı olan araştırmacılar için.

Hesaplama doğruluğu nedir?

Swiss Ephemeris, gezegen konumlarını ±1 yay saniyesine, ev küspislerini ±1 yay dakikasına kadar hassasiyetle hesaplar. Sonuçlar Astrodienst (Astro.com), Solar Fire, Zet 9 ve Kepler’e karşı doğrulanmıştır. NASA JPL ephemeris ve NASA 5-Millennium Eclipse Catalog’a karşı sub-arcsecond sapma.

AstroWay, Astro.com veya Solar Fire ile nasıl karşılaştırılır?

Aynı Swiss Ephemeris motorunu kullanır — Solar Fire ($495 lisans), Kepler ($995), Astro Gold ($29.99/ay) ve Astrodienst (Astro.com) ile aynı. Hesaplamalar NASA JPL ephemeris ve Astrodienst’in resmi swetest referansıyla doğrulanmıştır. Gezegen konumlarında sub-arcsecond sapma (≤0.1″), tutulmalarda ≤1 dakika. Fark: AstroWay, one-time license veya masaüstü GUI yerine aylık $5’dan başlayan REST API’dir.

Hangi ev sistemleri destekleniyor?

15 sistem: Varsayılan olarak Placidus, Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC ve MC’ye Equal. İlgili kodu houseSystem parametresine ilet.

Krediler ve Ödeme

Kredi sistemi nasıl çalışır?

Her endpoint, hesaplama karmaşıklığına bağlı olarak sabit bir kredi maliyetine sahiptir (10 ila 500 arasında). Basit bir lookup 10, doğum haritası 20, sinastri 50, rectifikasyon 500’dür. Tam tablo Fiyatlandırma sayfasında mevcuttur.

Ücretsiz bir plan var mı?

Evet. Free plan, ayda 10.000 kredi ve 10 req/dakika sunar. Kredi kartı gerekmez. Ürünü değerlendirmek ve prototiplemek için yeterlidir.

Krediler bittiğinde ne olur?

Free planında, istekler bir sonraki aya kadar engellenir (429 CREDITS_EXHAUSTED). Indie/Starter/Pro/Business planlarında, fazla kullanım devreye girer: 10.000 ek kredi için $5 / $3 / $2.

Aynı istekler önbelleğe alınır mı?

Evet. Aynı girdiyle yapılan 5 dakika içinde yapılan istekler, kredi harcanmadan önbellekten yanıtlanır. Bu durum X-Cache: HIT başlığıyla doğrulanır.

Kredileri abonelik olmadan satın alabilir miyim?

Henüz değil. Abonelik, öngörülebilir bir bütçe ve daha iyi rate limit sağlar. Pay-as-you-go planı planlanıyor.

Teknik

Hangi SDK’lar mevcut?

• MCP sunucusu ✅ yayınlandı: npx -y @astroway/mcp — Tüm 714+ endpoint’lerini Claude $1, Cursor, GPT ve diğer MCP uyumlu AI ajanları için araç olarak sunar
• TypeScript SDK ✅ yayınlandı: npm install @astroway/sdk — OpenAPI 3.1 tabanlı türler + otomatik tamamlama, retry + idempotency, Stainless tarzı hatalar
• Python SDK ✅ yayınlandı: pip install astroway — sync Astroway + async AsyncAstroway, httpx tabanlı, PEP 561 tip desteği
• PHP SDK ✅ yayınlandı: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 planlandı — Her SDK sayfasında (/sdk/<language>/) e-posta bildirimi için kaydolun

API sözleşmesi standart REST + JSON’dur, bu nedenle herhangi bir HTTP istemcisi SDK olmadan çalışır. Postman koleksiyonu ve OpenAPI 3.1 spec herkese açık olarak mevcuttur.

Sandbox modu var mı?

Evet. aw_test_* anahtarları kredi harcamaz ve aynı sonuçları döndürür. Geliştirme ve test için idealdir.

Rate limit nedir?

Plana bağlıdır: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1.000 req/dakika. Aşım durumunda 429 yanıtı ve Retry-After başlığıyla birlikte gelir.

Sidereal burç destekleniyor mu?

Evet. "zodiacType": "sidereal" ve isteğe bağlı olarak "ayanamsaId" (varsayılan — Lahiri) gönderin. Tüm endpoint’lerle çalışır.

Human Design endpoint’leri nelerdir?

Human Design hesaplamaları için 12 endpoint: tip, strateji, otorite, profil, tanımlama, enkarne haçı, kanallar, merkezler, Dream Rave, Hologenetic Profil, Penta (grup dinamikleri), zamansal hassasiyet. Ticari API’ler arasında en derin Human Design kapsamı.

Güvenlik ve Gizlilik

İstekler hakkında veri saklanır mı?

API stateful değildir — doğum tarih/saat/koordinat verileri işlemden sonra saklanmaz. Yalnızca meta veriler loglanır: key_id, endpoint, timestamp, latency, krediler. Kişisel veri yok.

API GDPR uyumlu mu?

Evet. Veri saklanmaz. AB kullanıcıları için: Kişisel olarak tanımlanabilir bilgilerin (PII) işlenmesi, profil oluşturma veya çerezler yok. API anahtarı hesaba, son kullanıcıya değil bağlıdır.

AI yorumları güvenli mi?

AI endpoint’leri (/interpret/*, /horoscope/*) yerleşik güvenlik önlemlerine sahiptir: tıbbi, yasal veya finansal tavsiyelerin yasaklanması. Her yanıt bir uyarı içerir. Tam denetim izi — enterprise uyumluluğu için.

Destek

Yardım nasıl alınır?

Plana bağlıdır: Free — topluluk, Indie — e-posta (48 saat), Starter — e-posta (24 saat), Pro — e-posta (4 saat), Business — e-posta + Slack (1 saat), Enterprise — Slack’te özel yönetici. İletişim bilgileri İletişim sayfasında mevcuttur.

SLA var mı?

Indie: %99 uptime. Starter ve Pro: %99.9 uptime. Business: %99.95 uptime. Enterprise: finansal garantilerle özel SLA.