NatalChart.AI API'si, NatalChart.AI uygulamasının geliştiricilere açılmış hesaplama motorudur. Doğum tarihini, saatini ve koordinatları gönderin, haritayı geri alın: barındırılacak efemeris dosyası, bakımı yapılacak saat dilimi tablosu, güncel tutulacak astroloji kütüphanesi yok.
Neler geliştirebilirsiniz
Doğum haritası sayfaları
Güneş, Ay ve yükselen burç, burcu ve eviyle her gezegen, orblarıyla açılar ve element dengesi; 1800 ile 2399 arasındaki her doğum için. /v1/chart/full, /v1/chart/short
Gerçek gökyüzünden günlük burç yorumları
Günün bir kişinin haritasına yaptığı transitler, her biri orbuyla ve güçlenmekte mi yoksa zayıflamakta mı olduğuyla birlikte; ayrıca Ay'ın evresi ve haftanın gökyüzü olayları. /v1/horoscope/daily, /v1/sky
Tanışma uygulamaları için uyum
İki haritanın karşılaştırması: aralarındaki her açı, her kişinin gezegenlerinin diğerinin hangi evlerine düştüğü ve her yaşam alanı için bir puan. /v1/synastry
Öngörüler ve önünüzdeki yıl
En fazla 92 günlük bir aralıktaki her tam transit ve herhangi bir yılın Güneş dönüşü haritası; doğum yeri için ya da kişinin o sırada bulunacağı yer için. /v1/transits, /v1/solar-return
En iyi günler
Bir aralığın her günü bir etkinlik (iş, aşk, seyahat, sağlık ve dahası) için puanlanır; lehte ve aleyhte olan transitlerle birlikte. /v1/timing
Astrokartografi ve relokasyon
Bir haritaya göre puanlanan tek bir şehir ya da o harita için sıralanan dünyanın büyük şehirleri; yaşam alanına ve bölgeye göre. /v1/locations/score, /v1/locations/rank
Bir dakikada başlayın
Bir anahtar oluşturun (ücretsiz, kart gerekmez), ardından bir doğum verisi gönderin:
curl https://api.natalchart.ai/v1/chart/short \
-H "Authorization: Bearer $NATALCHART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'Tüm uç noktalar, alanlar ve hatalar API belgelerinde yer alır; kod üreticileri için bunları OpenAPI belgesi tanımlar.
Kontrol edebileceğiniz doğruluk
Tropikal zodyak, Placidus ev sistemi, beş majör açı, gerçek Ay düğümü, derecenin dört ondalık basamağına kadar konumlar. Saat dilimi, doğum tarihindeki yaz saati kurallarıyla koordinatlardan belirlenir; doğum saati bilinmiyorsa evler ve köşe noktaları tahmin edilmek yerine dışarıda bırakılır. Doğruluk raporu motoru NASA JPL Horizons ile karşılaştırır; yayımlanan örnek harita ise herhangi bir kod yazmadan önce bir yanıtı kontrol etmenizi sağlar.
Yapay zekâ asistanları için: MCP sunucusu
Aynı hesaplamalar https://www.natalchart.ai/mcp adresinde bir MCP sunucusu olarak sunulur. Claude, ChatGPT, Cursor ve VS Code aynı anahtarla bağlanır ve harita, transit ve uyum araçlarını kendileri çağırır; böylece asistan tahmin edilmiş değil, hesaplanmış bir haritayı okur.
Fiyatlar
| Plan | Fiyat | İstekler | Uç noktalar |
|---|---|---|---|
| Ücretsiz | $0 | Günde 10 | Haritalar ve bölümleri, günlük burç yorumu, gökyüzü, kullanım |
| API Pro | Aylık $6.99 | Günde 1.000 | Her şey: transitler, sinastri, Güneş dönüşleri, en iyi günler, konumlar |
Havuz hesap başınadır ve 00:00 UTC'de yenilenir. Geçersiz olduğu için reddedilen bir istek sayılmaz ve doğum verileri asla saklanmaz: kayıtta yalnızca uç nokta, durum ve süre tutulur.
Sorular
Ücretsiz bir astroloji API'si var mı?
Evet. NatalChart.AI anahtarı ücretsizdir ve günde 10 istek hakkı verir: tam ya da bölüm bölüm doğum haritaları, bir haritaya yapılan transitlerle birlikte günlük gökyüzü ve herhangi bir tarih için gezegen konumları. Kart gerekmez. API Pro (aylık $6.99) havuzu günde 1.000 isteğe çıkarır ve bir dönemin transitlerini, sinastriyi, Güneş dönüşlerini, en iyi günleri ve astrokartografiyi açar.
Hesaplamalar ne kadar doğru?
Konumlar, profesyonel astroloji yazılımlarının standardı olan Swiss Ephemeris ile, veri dosyaları kullanılarak ve hız bayrağı açık olarak hesaplanır. NatalChart.AI uygulamasındaki her haritayı aynı motor çizer ve doğruluk raporu bu motorun çıktısını NASA JPL Horizons ile karşılaştırır.
Bunun üzerine bir burç yorumu ya da uyum uygulaması geliştirebilir miyim?
Evet, amacı da bu: doğum haritası sayfaları, gerçek transitlere dayalı günlük burç yorumları, tanışma uygulamaları için uyum puanları, en iyi gün seçicileri ve relokasyon haritaları. Ticari kullanıma iki planda da izin verilir; anahtarı kendi sunucunuzda tutun.
Yazılı yorumlar döndürüyor mu?
Hayır. API hesaplar ve sayılar döndürür: burçlar, dereceler, evler, orblarıyla açılar, yaşam alanı başına puanlar. Yapay zekâ çağrısı yoktur, bu yüzden aynı girdi her zaman aynı çıktıyı verir; sözcükler ise size ya da modelinize kalır.
Hangi programlama dilleri ve framework'lerle çalışır?
JSON gövdeli bir HTTPS isteği gönderebilen her şeyle: JavaScript, Python, PHP, Swift, Kotlin, kodsuz araçlar. Belgelerde kopyalayıp yapıştırabileceğiniz örnekler vardır ve bir OpenAPI belgesi, kod üreticileri için her uç noktayı tanımlar.
Yapay zekâ asistanları bunu kullanabilir mi?
Evet, MCP sunucusu üzerinden: Claude, ChatGPT, Cursor ve VS Code ona aynı anahtarla bağlanır ve hesaplamaları araç olarak çağırır.