Astrokartografi API'si

İstek

Gerçek bir istek: örnek haritaya göre Lizbon.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -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},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

Yanıt

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

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

Yanıtta neler var

• relocated: haritanın o yerdeki yükseleni ve Tepe Noktası (MC).
• angularPlanets: bu köşe noktalarındaki gezegenler; her biri köşe noktası, orbu ve gücüyle birlikte.
• spheres: Benlik, Aşk, Beden, Para, Yuva ve Zihin; her biri 0 ile 10 arasında (5 nötrdür); overall10 bunları tek bir puanda özetler.
• strength: bir ana gezegen bir köşe noktasına 2° içinde yakınsa güçlü, 4° içindeyse orta, aksi hâlde zayıf. Kurallar yanıtla birlikte gelir.
• POST /v1/locations/rank uç noktası katalogdaki en iyi şehirleri, altı alanın tümüne ya da seçtiğiniz alanlara göre, dünya genelinde ya da tek bir bölgede döndürür.

Limitler

• Yalnızca API Pro'da. Ücretsiz anahtarla iki uç nokta da 403 koduyla ve bir yükseltme bağlantısıyla yanıt verir.
• Doğum saati zorunludur: relokasyon köşe noktalarını kaydırır, köşe noktaları için de saat gerekir.
• Sıralama yeryüzündeki her yeri değil, 61 büyük şehri karşılaştırır; başka herhangi bir yer POST /v1/locations/score ile puanlanabilir.
• 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 tek bir yer için location_score aracını, en iyi şehirler için best_cities aracını çağırır.

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