2026’da bir astroloji uygulaması mı geliştiriyorsun? Pazar artık olgunlaştı - el yapımı efemeris hesaplamalarından bir avuç ticari API’ye geçildi. Seçim yapmadan önce bilmen gerekenler burada.
Bu pazarlama değil. Bir geliştiricinin görmek isteyeceği şey: endpoint sayısı, gerçek fiyatlar, SDK kalitesi, doğruluk iddiaları, her API’nin güçlü ve zayıf yönleri.
Bir astroloji API’sinde gerçekten önemli olan nedir
Section titled “Bir astroloji API’sinde gerçekten önemli olan nedir”Entegrasyon sırasında beş şey önemlidir:
- Kapsam: kaç teknik destekleniyor? Natal harita temel koşul; en azından sinastri, transitler ve progresyonlar gerekli. Rektifikasyon veya Human Design gibi premium özellikler ise artık farklılaştırıcı.
- Doğruluk: ±1 açı saniyesi Swiss Ephemeris standardıdır. Daha kötüsü - Astrodienst’te kontrol eden kullanıcılardan şikayet alırsın.
- Fiyatlandırma modeli: per-request, credit-based mi yoksa sabit aylık mı? Credit-based, karma yüke sahip projelerde daha iyi ölçeklenir.
- SDK kalitesi: tipli TypeScript ve Python SDK’ları saatler kazandırır. AI ajanları geliştiriyorsan MCP desteği kritiktir.
- Dokümantasyon: OpenAPI 3.1 spec minimumdur. İnteraktif playground büyük zaman tasarrufudur.
Başlıca oyuncular
Section titled “Başlıca oyuncular”Birkaç ticari astroloji API’si geliştiricilerin dikkati için yarışıyor. Manzara kabaca üç katmana ayrılıyor:
- Kapsamlı batı + vedik: her şeyi kapsamaya çalışan API’ler; genellikle batı astrolojisinden daha geniş vedik kapsamına sahiptir. Nakshatralar, dashalar ve vedik divisional haritalarda güçlü, ancak modern batı tekniklerinde çoğu zaman daha zayıf.
- Batı odaklı: batı astrolojisine artı bir “imza” özelliğe (Human Design, rektifikasyon, AI yorumları) odaklanan API’ler. Genellikle dar bir nişte daha derindir.
- AI-first: temel hesaplamaların etrafına bir LLM (genellikle GPT-4, Claude 3.5 veya Llama 3.3) saran ve “astroloji için ChatGPT” olarak konumlanan API’ler. Kullanımı kolay, ancak kaputun altındaki hesaplamalar çoğu zaman yüzeysel - gerçek efemeris yok, AI tarihleri ±15 gün halüsinasyonla uyduruyor.
AstroWay API bunun neresinde? Batı odaklı + Human Design + AI yorumları. 771 endpoint, Swiss Ephemeris doğruluğu, 12 HD endpoint’i, credit-based fiyatlandırma.
Karşılaştırmalı tablo
Section titled “Karşılaştırmalı tablo”| Özellik | AstroWay | Tipik vedic-first | Tipik AI-first |
|---|---|---|---|
| Endpoint’ler | 771 | 40–60 | 10–20 |
| Doğruluk | ±1” (Swiss Ephemeris) | değişken | değişken |
| Natal harita | evet | evet | evet |
| Sinastri | evet (0–100 skor) | sıklıkla | bazen |
| Progresyonlar | evet (secondary + tertiary + minor) | nadiren | nadiren |
| Rektifikasyon | evet (algoritma + Trutine) | hayır | hayır |
| Human Design | 12 endpoint | bazen temel | nadiren |
| AI yorumları | safety-guardrail’li 10 endpoint | bazen | evet |
| MCP sunucusu | evet (25 araç) | hayır | bazen |
| TypeScript SDK | evet (tipli) | bazen | bazen |
| Python SDK | evet (context manager) | bazen | bazen |
| OpenAPI 3.1 spec | evet | bazen | nadiren |
| Ücretsiz plan | 10 000 kredi / ay | sınırlı | yalnızca trial |
Farklılaştırıcı olarak nadir teknikler
Section titled “Farklılaştırıcı olarak nadir teknikler”Harmonic haritalar, antiscia, Gauquelin sectors veya Barbault cyclic index gerekiyorsa - çoğu API bunları desteklemez. Bu bir niş, ancak araştırma uygulamaları, geleneksel astroloji ve akademik çalışmalar için çok değerli.
AstroWay bilinçli olarak bu nişte çalışıyor:
- Harmonic haritalar (H2–H180): John Addey’in araştırma yöntemi
- CCG (Cyclo-Carto-Graphy): progresse edilmiş astrokartografi
- Rektifikasyon: doğum saatinin algoritmik hassaslaştırılması
- Gauquelin sectors: istatistiksel astroloji
- Antiscia: klasik Helenistik teknik
- Disposition chains: yöneticilik grafik analizi
- Tam Human Design: Penta ve Dream Rave dahil 12 endpoint
Uygulaman bu listeden bir şeye ihtiyaç duyuyorsa - seçenekler hızla daralır.
Pratikte fiyatlandırma
Section titled “Pratikte fiyatlandırma”Çoğu ticari API ya per-request ya da aylık kota üzerinden ücretlendirir. İstek başına fiyat ucuz görünür ($0.01–0.05 çağrı başına), ancak kötü ölçeklenir - kullanıcı sayısı sıçrarsa maliyetler patlar.
Credit-based fiyatlandırma (AstroWay’deki gibi) endpoint’in karmaşıklığına göre farklı miktar düşer:
- Basit sorgu için 10 kredi (gezegen konumları)
- Tam natal harita için 20
- Sinastri için 50
- Rektifikasyon için 500
Bu, gerçek hesaplama maliyetini daha iyi yansıtır. Günde 1 000 natal haritalık küçük bir uygulama - yaklaşık 20 000 kredi; Starter ($19/ay) bunu karşılar.
SDK kalitesi göründüğünden daha önemli
Section titled “SDK kalitesi göründüğünden daha önemli”Ham HTTP çağrıları işe yarar, ancak tipli SDK’lar şunlarda saatler kazandırır:
- Parametre adlarını hatırlamak için dokümantasyon okumak
- Yanlış tipleri runtime’dan önce yakalamak
- IDE’de yanıt alanlarının otomatik tamamlanması
AstroWay’in TypeScript SDK’sı tam type inference ile tüm 771 endpoint’i kapsar:
const chart = await client.chart({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});
// TypeScript knows chart.planets is Planet[], not anyfor (const planet of chart.planets) { console.log(`${planet.name} at ${planet.longitude}°`);}AI ajanları için MCP
Section titled “AI ajanları için MCP”Bir AI ajanı geliştiriyorsan (Claude Desktop için custom tool’lar, koçluk chatbot’u veya ChatGPT’ye astroloji entegrasyonu), Model Context Protocol (MCP) artık standarttır. MCP sunucusu, API’ni modelin doğrudan çağırabileceği tool’lar olarak sunar.
AstroWay’in MCP sunucusu 25 araç sağlar - natal haritalar, sinastri, transitler, burç yorumları ve 12 HD endpoint’inin tamamı. Kurulum:
{ "mcpServers": { "astroway": { "command": "npx", "args": ["@astroway/mcp"], "env": { "ASTROWAY_API_KEY": "aw_live_..." } } }}Otuz saniye - ve Claude’un 25 yeni astroloji aracı var.
Tek bir “en iyi” API yok - her şey ne geliştirdiğine bağlı:
- Standart batı işlevselliğine sahip bir uygulama mı? AstroWay veya benzeri batı odaklı bir API.
- Ana özellik vedik mi? Vedik uzmanı API’lere bak; AstroWay’de temel vedik (nakshatralar, divisional charts) var, ancak ana odak değil.
- AI ajanı mı geliştiriyorsun? MCP desteği zorunlu. AstroWay ve birkaç API daha bunu sunuyor.
- Nadir teknikler mi gerekiyor (rektifikasyon, Human Design, harmonics)? AstroWay tam da bunun için.
Birkaçını test et. Her API’nin ücretsiz planı var - aynı endpoint’i üçüne karşı yaz, doğruluğu, gecikmeyi ve DX’i karşılaştır. Projen için neyin uygun olduğunu anlamanın tek yolu bu.
AstroWay ile başla
Section titled “AstroWay ile başla”AstroWay aradığın şey gibi görünüyorsa:
- Hızlı başlangıç: 5 dakikada ilk istek
- Fiyatlandırma: ayda 10 000 kredili ücretsiz plan
- API reference: playground ile tüm 771 endpoint
Solar Fire'daki aynı Swiss Ephemeris - 4 satır kodla.
Kart gerekmeden ücretsiz anahtar. İlk ödemeye kadar ayda 5.000 istek.