Genel
AstroWay API nedir?
Profesyonel HTTP API astrolojik hesaplamalar için. 771 endpoint Swiss Ephemeris tabanlı: natal haritalar, sinastri, prognozlar, direksiyonlar, transitler, Human Design, astro-kartografi, rectifikasyon, AI-yorumlamalar. Tüm hesaplamalar sunucuda yapılır - istemci tarafında hiçbir bağımlılık yok.
Bu API kimler için?
Astrolojik uygulamalar (web/mobile) geliştiren geliştiriciler, astrolojik özellikler ekleyen AI şirketleri, scriptleri olan profesyonel astrologlar ve hesaplamalara programatik erişime ihtiyaç duyan araştırmacılar için.
Hesaplamaların doğruluğu nedir?
Swiss Ephemeris, gezegen konumlarını ±1 açı saniyesine, ev kısmalarını ±1 açı dakikasına kadar doğruluk sağlar. Sonuçlar Astrodienst (Astro.com), Solar Fire, Zet 9 ve Kepler ile 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 motoru - Solar Fire ($495 lisans), Kepler ($995), Astro Gold ($29.99/ay) ve Astrodienst (Astro.com) ile aynı. NASA JPL ephemeris ve Astrodienst’in resmi swetest referansı ile doğrulanmıştır. Gezegen konumlarında sub-arcsecond sapma (≤0.1″), tutulmalarda ≤1 dakika. Fark: AstroWay - one-time lisans veya masaüstü GUI yerine $5/ay’dan başlayan REST API.
Hangi ev sistemleri destekleniyor?
15 sistem: Placidus (varsayılan), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC ve MC’den Equal. houseSystem parametresine uygun kodu gönder.
Kredit ve ödeme
Kredi sistemi nasıl çalışır?
Her endpoint, hesaplamanın karmaşıklığına bağlı olarak sabit bir kredit maliyetine sahiptir (10 ile 500 arasında). Basit lookup - 10, natal harita - 20, sinastri - 50, rectifikasyon - 500. Tam tablo Tarifeler sayfasında.
Ücretsiz tarif var mı?
Evet. Free planı ayda 10 000 kredit, 10 req/dakika verir. Kart bilgisi gerektirmez. Ürünü değerlendirmek ve prototip oluşturmak için yeterli.
Kreditler bittiğinde ne olur?
Free planında - istekler bir sonraki aya kadar bloklanır (429 CREDITS_EXHAUSTED). Indie/Starter/Pro/Business planlarında - ek kredi ücretleri devreye girer: 10 000 ek kredit için $5 / $3 / $2.
Aynı istekler önbelleğe alınıyor mu?
Evet. Aynı input 5 dakika içinde önbellekten kredi harcamadan döner. X-Cache: HIT başlığıyla onaylanır.
Abonelik olmadan kredit satın alabilir miyim?
Şimdilik hayır. Abonelik, öngörülebilir bütçe ve daha iyi rate limit sağlar. Pay-as-you-go planı planlanıyor.
Teknik
Hangi SDK’lar mevcut?
- MCP sunucu ✅ olgunlaştırıldı:
npx -y @astroway/mcp: tüm 771+ endpoint’leri Claude Desktop, Cursor, GPT ve diğer MCP uyumlu AI ajanları için araç olarak sunar - TypeScript SDK ✅ olgunlaştırıldı:
npm install @astroway/sdk: tipler + autocomplete OpenAPI 3.1 ile, retry + idempotency, Stainless tarzı hatalar - Python SDK ✅ olgunlaştırıldı:
pip install astroway: syncAstroway+ asyncAsyncAstroway,httpxtabanlı, PEP 561 tipli - PHP SDK ✅ olgunlaştırıldı:
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 ile bildirim alın
API sözleşmesi standart REST + JSON’dir, bu yüzden herhangi bir HTTP istemcisi SDK olmadan çalışır. Postman koleksiyonu ve OpenAPI 3.1 spec kamuya açıktır.
Sandbox modu var mı?
Evet. aw_test_* anahtarları kredit harcamaz ve aynı sonuçları döndürür. Geliştirme ve test için idealdir.
Rate limit nedir?
Plana bağlı: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1 000 req/dak. Aşımda - 429 ve Retry-After başlığı.
Sidereal burç destekleniyor mu?
Evet. "zodiacType": "sidereal" ve isteğe bağlı olarak "ayanamsaId" (varsayılan - Lahiri) gönder. Tüm endpoint’lerde çalışır.
Human Design endpoint’leri nedir?
Human Design hesaplaması için 12 endpoint: tip, strateji, otorite, profil, tanım, inkarnasyon çarpıtması, kanallar, merkezler, Dream Rave, Hologenetic Profile, Penta (grup dinamiği), zaman duyarlılığı. Ticari API’ler arasında en derin HD kapsamı.
Güvenlik ve gizlilik
İstek verileri saklanıyor mu?
API stateless çalışır - doğum tarihi/saat/koordinat verileri istek işlendiğinde saklanmaz. Yalnızca meta veriler loglanır: key_id, endpoint, timestamp, latency, kredit. Kişisel veri yok.
API GDPR gereksinimlerine uyuyor mu?
Evet. Veriler saklanmaz. AB kullanıcıları için: PII işlenmez, profil oluşturulmaz, çerez yok. API anahtarı hesaba bağlıdır, son kullanıcıya değil.
AI yorumlamaları güvenli mi?
AI endpoint’leri (/interpret/*, /horoscope/*) yerleşik safety guardrails içerir: tıbbi, hukuki, finansal tavsiye yasaktır. Her yanıt bir sorumluluk reddi içerir. Tam audit trail, kurumsal uyumluluk için.
Destek
Yardım nasıl alınır?
Plana bağlı: 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 ayrılmış yönetici. İletişim İletişim sayfasında.
SLA var mı?
Indie: %99 uptime. Starter ve Pro: %99.9 uptime. Business: %99.95 uptime. Enterprise: finansal garantili özel SLA.
Benzer isimler
AstroWay API (astroway.info), astroway.life’den ‘Astroway’ aboneliğiyle ilişkili mi?
Hayır. astroway.info ve api.astroway.info ayrı, bağımsız bir şirket. Geliştiriciler için astrolojik API (api.astroway.info), son kullanıcılar için uygulama (app.astroway.info) ve astrolog danışmanlığı sağlıyoruz. Biz, astroway.life üzerinden “Astroway” adıyla tanıtılan ve faturalandırılan tüketici astrolojik aboneliğiyle hiçbir bağlantımız yok. Bu aboneliğin operatörü TrafficLeader OÜ (Estonya, ayrıca traffic-leader.com); ilişkili faturalandırıcı SKYREAD.PRO - ABCMobile OÜ (Estonya). Sadece isim benzerliği var - farklı şirketler.
”Astroway” beni ücretlendiriyor - aboneliği nasıl iptal eder ve para iadesi alırım?
Eğer “Astroway” aboneliği için (no-reply@astroway.life den gelen e-postalar, banka ekstresinde “Astroway” olarak) ücret alınıyorsa, bu başka bir şirket, astroway.life, biz değiliz. Bu hizmetteki hesabınıza veya ödemelerinize erişimimiz yok, bu yüzden aboneliği iptal edemeyiz veya para iadesi yapamayız. Yapmanız gereken:
no-reply@astroway.lifeadresine doğrudan yanıt verin ve e-postanın alt kısmındaki “aboneliği iptal et / çık” bağlantısını kullanın.- Yanıt alamazsanız: bankanıza veya kartınızı veren kuruma (ekstrede “Astroway” ödemesi; satıcı TrafficLeader OÜ veya ABCMobile OÜ / SKYREAD.PRO, Estonya) başvurun ve tekrar eden tahsilatları engellemesini veya iade (chargeback) talep etmesini isteyin.