Güneş Dönüşü API'si

İstek

Gerçek bir istek: örnek haritanın 2027 yılındaki dönüşü, doğum yeri için.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

Yanıt

Bu isteğe verilen yanıtın bir bölümü: ana alanlar; her liste ilk üç öğesine kısaltılmıştır.

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

Yanıtta neler var

• exactMomentUtc: Güneş'in yeniden natal boylamına ulaştığı an, UTC cinsinden.
• location: haritanın kurulduğu yer; başka bir yer göndermezseniz doğum yeri.
• natalSun: dönüşün ölçüldüğü natal Güneş boylamı.
• chart: o an ve o yer için tam harita, doğum haritası uç noktasıyla aynı yapıda.

Limitler

• Yalnızca API Pro'da. Ücretsiz anahtarla uç nokta 403 koduyla ve bir yükseltme bağlantısıyla yanıt verir.
• Doğum saati zorunludur.
• Tropikal zodyak ve Placidus ev sistemi; doğum haritasıyla aynı ayarlar.
• Doğum verileri okunur, kullanılır ve unutulur: istek gövdeleri asla saklanmaz.

Yapay zekâ asistanlarında

https://www.natalchart.ai/mcp adresindeki MCP sunucusu üzerinden asistanlar solar_return aracını çağırır ve önümüzdeki yılı hesaplanmış bir haritadan okur.

API'nin geri kalanı

Aynı anahtar astroloji API'sinin tamamını açar: doğum haritaları, günlük transitler, sinastri, bir dönemin transitleri, Güneş dönüşleri, en iyi günler ve astrokartografi. Tüm uç noktalar, alanlar ve hatalar belgelerde yer alır; neyin istek sayıldığını ise fiyatlar sayfası açıklar.

Sorular