AstroWay API Lansmanı: Swiss Ephemeris Doğruluğu ile Astrolojik Hesaplamalar

Bugün AstroWay API’yi duyuruyoruz - astrolojik uygulamalar, horoskop ürünleri, eşleşme için uyumluluk fonksiyonları ve doğum haritaları üzerine düşünen AI ajanları geliştiren geliştiriciler için hesaplama backend’i.

Bu yazıda - API’nin içinde gerçekte ne var, hangi alışılmadık çözümleri benimsedik, neyi bilerek parantez içinde bıraktık ve buraya nasıl geldik. Süzgeçsiz.

🕓 Kayıt 2026-04-22, güncellendi 2026-05-09. Bazı sayılar eski. Güncel durum: 865 endpoint (launch anında 87 değil), 888 CI snapshot testi (183 değil), MCP-sunucu @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk artık public registries’de yaşıyor. Güncel durum - /faq ve changelog sayfalarında.

REST API, Swiss Ephemeris tabanlı - artık gerçek hesaplamaların üzerine AI yorumlamaları da ekli. Aynı motor, profesyonel astrologların 30+ yıldır Solar Fire, Kepler, Astro Gold ve Janus’ta kullandığı - açısal saniyenin bir kesri kadar hassas, NASA JPL efemeridi ve Astrodienst (Astro.com) resmi swetest referansı ile doğrulanmış.

Rakamlar:

• 865 endpoint: Batı natal astrologisi, sinastri, transitler, ilerlemeler, yönlendirmeler, dönüşler, harmonikler, sabit yıldızlar, Arap noktaları, astro‑kartografi ve tam Human Design seti
• 183 snapshot testi CI’de gerçek swetest CGI çıktısı ve NASA gölge kataloğu karşısında - her PR’de koşuluyor
• p50 < 100 ms, p95 < 500 ms tipik hesaplama endpoint’leri için
• MCP-sunucu @astroway/mcp + üç SDK public registries’de: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - aynı API üç dilde
• MCP-sunucu: @astroway/mcp - API’yi Claude, GPT, Cursor ve diğer LLM ajanları için araç olarak sunar
• Kredi tabanlı tarifeler: ücretsiz plan (10 000 kredi / ay, kart gerektirmez), ücretli - $5 / ay’dan başlayan

Tam dokümantasyon: api.astroway.info/docs/api/. Canlı durum: api.astroway.info/status.

Üç yıl önce tüketici astrolojik uygulamalar geliştirmeye başladık. Hesaplama katmanı en zor kısım çıktı - UI ya da içerikten çok daha karmaşık. Mevcut hizmetler ya:

1. Yüzeysel bir kapsama sahipti (10–30 endpoint, çoğunlukla sadece natal)
2. Ölçeklendikçe pahalıydı ($0.02–$0.10 istek başına toplu indirim olmadan)
3. Kapalı motorlar kullanıyordu, doğrulukları doğrulanamıyordu
4. Vedik astrolojiye odaklanmış, Batı astrolojiyi ikincil olarak sunuyordu

Bu yüzden Swiss Ephemeris’i kendi başımıza vendorledik ve kendi hesaplama katmanımızı yazdık - önce tüketici ürünü app.astroway.info için, ardından Marketing sitesi astroway.info için, ki bu site ayda yüz binlerce ziyaretçiye günlük horoskoplar sunuyor.

Bu kodun üretimde üç yıl çalışması sonucunda iki sonuç çıkardık:

1. Aynı hesaplama motoru diğer geliştiricilere de açık olmalı: çünkü onları kendi başlarından yazamazlar diye değil, kütüphane + önbellekleme + doğruluk için CI yığını yarım yıl süren bir iş ve kimsenin tekrarlaması gerekmiyor.
2. Human Design kapsamımız (12 endpoint: harita, tip, otorite, profil, kapılar, kanallar, konturlar, gezegen aktivasyonları, incarnation cross, definition) gerçekten benzersiz. Hiçbir rakip tam HD yığınını API üzerinden sunmuyor.

İşte bu lansman.

Bizde /nakshatras, /ashtakavarga ve bölünmüş haritalar için endpoint’ler var, ama Dasha, Panchang, Ashtakoota, KP yok. Sebep: Vedik astrolojide okullar arasında çözülememiş anlaşmazlıklar var (ayanamsh savaşları, KP kuspidleri tartışmaları, dasha okulu seçimi). Vedik kısmı Prokerala ve VedicAstroAPI’ye karşı aceleyle yapmak eleştiri alırdı.

Çözüm sabitlendi: vedik paket ayrı bir faz 3, batı için istikrarlı talep oluştuğunda ve Jagannatha Hora ve Parashara’s Light’a karşı doğrulama zamanı geldiğinde. Kötü bir şekilde yayınlamaktan tamamen yayınlamamayı tercih ederiz.

/chart bir çağrı, 365 günlük /forecast-calendar’a göre ~50 kat daha az hesaplama gerektirir. Tek bir istek fiyatı ya hafif kullanıcıları dışlar ya da ağır kullanıcıları sübvanse eder. Krediler maliyeti gerçek işe eşler - fiyatlandırma sayfasındaki endpoint tablosuna bak.

Yanıtlar ücretsiz planda _footer alanı içerir:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Bu bize hiçbir maliyet getirmiyor ve ücretsiz kullanıcılar için küçük bir yükseltme teşviki sağlıyor. Hobby+ planında anahtar ayarlarından kaldırılıyor. Deseni Zapier ve RevenueCat’ten ödünç aldık.

/rectification (yaşam olayları üzerinden likelihood-grid aramasıyla doğum zamanı seçimi) - hesaplama açısından pahalı: bir çağrı 10–60 saniye sürer ve Swiss Ephemeris ile on binlerce ara hesaplama yapar. Bunu Pro planı ($59 / ay) ile sınırladık ve yüksek bir kredi fiyatı koyduk, çünkü kötüye kullanım tüm diğerleri için ortak altyapıyı zorlayabilirdi.

/interpret/* endpoint’leri, birkaç model arasında otomatik failover yapan özel AI-gateway’imiz üzerinden çalışıyor. Seni kendi prompt’larımızla kilitlemiyoruz - yorumlu her yanıt temel hesaplamaları içerir, bu yüzden sesimiz sana uymuyorsa kendi LLM’ni kullanarak yeniden programlayabilirsin. Tam prompt’ları ve çıktıları B2B uyumluluğu için audit tablosuna (90 gün saklama) kaydediyoruz.

• Vedik paket: faz 3, talebin ilk onaylarından sonra (yukarıya bak)
• Eşik ulaşımında webhook’lar: uygulanmış, ama UI ham; üzerinde çalışıyoruz
• Public widget’lar (<script src="api.astroway.info/widget/natal.js">) - faz 7
• Ana Marketing sitesine eklenti: ayrı bir proje, astroway.info ekosistemi kapsamında planlanıyor

1. Dokümantasyonu oku nedenini anlamak istiyorsan: api.astroway.info/overview
2. 5 dakikada hızlı başlangıç kodla: Astrology API Quick Start
3. Fiyatlandırmalar, endpoint başına kredi tablosu dahil: api.astroway.info/pricing
4. Kaydol: ücretsiz, kart gerektirmez: api.astroway.info/dashboard/sign-up

API üzerinde bir şey inşa edersen - ya bir bug yakalarsın ya da henüz olmayan bir endpoint istersen - bize yaz. Yüzlerce geliştiricinin ne istediğini duymak, kimsenin kullanmadığı özellikleri yayınlamaktan daha iyidir.

Sorular, istekler, garip edge-case’ler: hello@astroway.info.

Yol haritası halka açık - PRODUCT-PLAN.md - neler yapıldı, ne gelecek, ne ertelendi ve neden.

Hoş geldin.