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

Bugün AstroWay API’yi duyuruyoruz — geliştiriciler için astrolojik uygulamalar, burç ürünleri, flört uygulamaları için uyumluluk özellikleri ve doğum haritaları hakkında akıl yürüten AI ajanlar için hesaplamalı bir arka uç.

Bu makalede - API’nin içinde neler var, hangi alışılmadık kararlar aldık, bilinçli olarak dışarıda bıraktıklarımız ve nasıl buraya geldiğimiz hakkında bilgi vereceğiz. Susuz.

🕓 2026-04-22’de kaydedildi, 2026-05-09’da güncellendi. Bazı rakamlar eskimiştir. Geçerli durum: 723 endpoint (lansman anında 87 değil), 818 CI snapshot testi (183 değil), MCP sunucusu @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk artık tümü kamu đăng kýlarında yaşıyor. Güncel durum - /faq ve changelog adreslerinde.

Swiss Ephemeris (LGPL) tabanlı REST API, WASM olarak derlenen ve Node.js hizmeti olarak dağıtılan - şimdi ayrıca AI yorumlamalarıyla (GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral failover zinciri) gerçek hesaplamaların üzerine kurulmuştur. Solar Fire, Kepler, Astro Gold ve Janus’da 30+ yıldır profesyonel astrologlar tarafından kullanılan aynı motor - NASA JPL ephemeris ve Astrodienst (Astro.com) tarafından sağlanan resmi swetest referansıyla karşılaştırılmış, kутangular saniye hassasiyetine sahip.

Rakamlar:

• 723 endpoint - batı doğum haritası astrolojisi, sinastri, transitler, ilerlemeler, direktler, dönüşler, harmonikler, sabit yıldızlar, arap noktaları, astrokartografi ve tam bir Human Design seti
• 183 snapshot testi CI’de gerçek swetest CGI çıkışı ve NASA’nın tutulma kataloğu ile karşılaştırıldı - her PR’de çalıştırılıyor
• p50 < 100 ms, p95 < 500 ms için tipik hesaplamalı endpoint’ler
• MCP sunucusu @astroway/mcp + üç SDK kamu đăng kýlarında: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - aynı API üç dilde
• MCP sunucusu: @astroway/mcp - API’yi Claude, GPT, Cursor ve diğer LLM ajanları için araçlar olarak sunar
• Kredi tabanlı fiyatlar: ücretsiz plan (10 000 kredi / ay, kart gerekmez), ücretli - $5 / ay’dan başlıyor

Tam belge: api.astroway.info/docs/api/. Canlı durum: api.astroway.info/status.

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

1. Yüzeysel kapsama sahipti (10-30 endpoint, çoğunlukla yalnızca doğum)
2. Ölçeklendirirken pahalıydı ($0.02-$0.10 talep başına, toptan indirimler olmadan)
3. Kapalı motorlar kullandı, bunların doğruluğunu kontrol etmek mümkün değildi
4. Vedik astrolojiye odaklandı, batı astrolojisini ikincil olarak sundu

Bu nedenle Swiss Ephemeris’i kendimiz entegre ettik ve kendi hesaplamalı katmanımızı yazdık - önce tüketici ürünümüz app.astroway.info için, sonra pazarlama sitesimiz astroway.info için, bu site ayda yüz binlerce ziyaretçiye günlük burçlar sunuyor.

Bu kodun üretimde üç yıllık çalışması sonucunda iki sonuca vardık:

1. Aynı hesaplamalı motorun diğer geliştiriciler için de erişilebilir olması gerekiyor - bunu, kendi hesaplamalı motorunu yazamayacakları için değil, sondern kütüphane + WASM + önbelleğe alma + CI doğruluk yığınının yarım yıl süren bir çalışma olduğunu ve kimsenin bunu tekrarlamaması gerektiğini düşündüğümüz için.
2. Human Design kapsamı (12 endpoint - harita, tip, otorite, profil, kapılar, kanallar, konturlar, gezegen aktivasyonları, enkarnasyon haçı, tanım) gerçekten benzersiz. Hiçbir rakip, API aracılığıyla tam HD yığınını sunmuyor.

İşte bu reason.

/nakshatras, /ashtakavarga ve bölünsel haritalar için endpoint’lerimiz var, ancak Dasha, Panchang, Ashtakoota, KP yok. Sebep: vedik astrolojide okullar arasında (ayanamsha savaşları, KP kuspidleri tartışmaları, okul seçimi) çözülmemiş farklılıklar var. Aceleyle yapılan vedik kısım, Prokerala ve VedicAstroAPI’ye karşı sadece eleştiriler alırdı.

Karar verildi: vedik paket - üçüncü aşama, batı ve Jagannatha Hora ve Parashara’s Light karşı doğrulama için istikrarlı talebin ardından. Kötü bir şekilde başlatmak yerine hiç başlatmamak daha iyi.

Tek bir /chart çağrısı, 365 günlük /forecast-calendar çağrısından yaklaşık 50 kat daha az hesaplama gerektirir. Düz bir talep ücreti veya düşük kullanıcıları kesecek veya ağır kullanıcıları sübvanse edecekti. Krediler, maliyeti gerçek işlemlere eşler - endpoint’ler için fiyat tablosuna bakın fiyat sayfasında.

Ücretsiz planın yanıtları _footer alanını içerir:

{
  "data": { ... },
  "_footer": "AstroWay API tarafından sağlandı - kendi anahtarınızı api.astroway.info'da alın"
}

Bize hiçbir şey maliyeti yok, ancak ücretsiz kullanıcılar için küçük bir güncelleme nedeni sunuyor. Hobby+ planında, anahtar ayarlarında kaldırılıyor. Desen, Zapier ve RevenueCat’ten ödünç alındı.

/rectification (doğum zamanını yaşam olayları aracılığıyla olasılıkagrid aramasıyla belirleme) - hesaplama açısından pahalı: bir çağrı 10-60 saniye sürer ve binlerce ara hesaplamayı Swiss Ephemeris gerçekleştirir. Bunu Pro planına ($59 / ay) sınırladık ve büyük bir kredi ücreti koyduk, çünkü suistimal, tüm diğer kullanıcılar için ortak altyapıyı bozacaktı.

/interpret/* endpoint’leri, en iyi pazar modellerinin (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) üzerinden otomatik failover ile çalışan özel AI geçidimize yönlendirilir. Sizi kendi promt’larınızla kilitlenmeye zorlamıyoruz - her yorumlama yanıtı, kendi LLM’nizi kullanmak isterseniz, kaynak hesaplamaları içerir. Tam promt’lar ve çıktılar, B2B uyumluluğu için denetim tablosunda (90 gün saklama) kaydedilir.

• Vedik paket - üçüncü aşama, ilk taleplerin ardından (yukarıya bakın)
• Eşik değerlerine ulaşıldığında webhook’lar - uygulanmış, ancak UI ham; geliştiriyoruz
• Halka açık widget’lar (<script src="api.astroway.info/widget/natal.js">) - yedinci aşama
• Temel pazarlama sitesine eklenti - ayrı bir proje, AstroWay.info ekosisteminin bir parçası olarak planlanıyor

1. Belgeleri okuyun eğer “neden” anlamak istiyorsanız: api.astroway.info/overview
2. 5 dakikada hızlı başlangıç kodla: Astroloji API Hızlı Başlangıç
3. Fiyatlar, endpoint’ler için kredi tablosu dahil: api.astroway.info/pricing
4. Kayıt olun - ücretsiz, kart gerekmez: api.astroway.info/dashboard/sign-up

Eğer API üzerinde bir şeyler inşa ederseniz veya bir hata ile karşılaşırsanız veya mevcut olmayan bir endpoint istiyorsanız - bize yazın. Yüz geliştiricinin talebini duymaktan, kullanılmayan özellikler başlatmaktan daha iyidir.

Sorular, talepler, garip edge durumları: hello@astroway.info.

Yol haritası kamu malı - PRODUCT-PLAN.md - ne yapıldı, ne следующий, ne ertelendi ve neden.

Hoş geldiniz.