POST/api/astro/horoscope-match/1 kredi

Evlilik uyumu

Yıldız numaraları yerine iki kişinin doğum bilgilerinden yapılan eksiksiz Ashtakoota evlilik uyumu. Her iki tarafın doğum tarihini, saatini ve yerini gönderin; endpoint Ay burcunu, nakshatrayı ve padayı kendisi hesaplar, sekiz kootayı 36 üzerinden puanlar, iki engelleyici doşayı kontrol eder ve bir karar döndürür. Yanıt dört bölümden oluşur. `boy` ve `girl` her haritanın özetidir: Ay burcu, nakshatra adı ve numarası, pada, Ay boylamı ve yükselen burç. `gunas`, her koota için bir tane olmak üzere sekiz nesneden oluşan bir listedir. Her nesnede `key` ve `label`, `max_points` ve `obtained_points`, karşılaştırılan `boy_value` ve `girl_value` (varna, yoni hayvanı, gana vb.), kootanın ilgili olduğu `area_of_life` ve sade İngilizce bir `description` bulunur — hiç metin yazmadan bir sonuç tablosu oluşturmaya yeter. Ardından `total_score`, değeri 36 olan `max_score` ve değeri 18 olan `minimum_recommended_score` gelir. En sonda `doshas`, `verdict` ve `verdict_reason` yer alır. Nadi puanı sıfırsa Nadi doşası, Bhakoot puanı sıfırsa Bhakoot doşası oluşur; ikisinden biri, toplam puan ne olursa olsun kararı 'Union is NOT Recommended' yapar. Aksi hâlde 28 ve üstü 'Union is Excellent', 18 ve üstü 'Union is Good' sonucunu verir; bunun altı önerilmez. Her kişi nesnesi `date_time`, `latitude`, `longitude` ve `timezone_as_float` alır; ayrıca isteğe bağlı `name` ve `city` etiketleri alınır ve olduğu gibi geri döndürülür. Her zaman Lahiri ayanamsası kullanılır; `ayanamsa` alanı kabul edilir ama hiçbir etkisi yoktur.

https://api.occultapi.com/api/astro/horoscope-match/

İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

İstek alanları

Alan	Tür	Zorunlu	Notlar
boy	object	zorunlu	Anahtarları sabit bir NESNE: name (string, isteğe bağlı, serbest biçimli etiket), date_time (zorunlu, ISO-8601), latitude (zorunlu, -89.9..89.9), longitude (zorunlu, -180..180), timezone_as_float (zorunlu, -12.0..14.0), city (string, isteğe bağlı, serbest biçimli etiket). `name` ve `city` doğrulanmaz ve hesaplamayı etkilemez.
girl	object	zorunlu	NESNE - yapısı ve kuralları `boy` ile aynıdır.
ayanamsa	string	isteğe bağlı

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/horoscope-match/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boy":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5},"girl":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}}'

Yanıt

{
  "data": {
    "boy": {
      "name": "",
      "city": "",
      "moon_sign": "Aries",
      "nakshatra": "Ashwini",
      "nakshatra_number": 1,
      "paadha_number": 1,
      "moon_longitude": 1.478,
      "ascendant_sign": "Leo"
    },
    "girl": {
      "name": "",
      "city": "",
      "moon_sign": "Aries",
      "nakshatra": "Ashwini",
      "nakshatra_number": 1,
      "paadha_number": 1,
      "moon_longitude": 1.478,
      "ascendant_sign": "Leo"
    },
    "gunas": [
      {
        "key": "varna",
        "label": "Varna",
        "max_points": 1,
        "obtained_points": 1,
        "boy_value": "Brahmin",
        "girl_value": "Brahmin",
        "area_of_life": "Obedience",
        "description": "Varna Kuta is assigned 1 point. It represents mutual love, comfort and obedience - the spiritual compatibility between the couple."
      },
      {
        "key": "vashya",
        "label": "Vashya",
        "max_points": 2,
        "obtained_points": 2,
        "boy_value": "Chatushpada",
        "girl_value": "Chatushpada",
        "area_of_life": "Mutual Control",
        "description": "Vashya Kuta is assigned 2 points. It represents mutual control or dominance, along with friendship and amenability between the couple."
      },
      {
        "key": "tara",
        "label": "Tara",
        "max_points": 3,
        "obtained_points": 3,
        "boy_value": "Sampat",
        "girl_value": "Sampat",
        "area_of_life": "Luck",
        "description": "Tara Kuta is assigned 3 points. It represents luck, auspiciousness and the transmission of mutual well-being between the couple."
      },
      {
        "key": "yoni",
        "label": "Yoni",
        "max_points": 4,
        "obtained_points": 4,
        "boy_value": "Horse",
        "girl_value": "Horse",
        "area_of_life": "Sexual Aspects",
        "description": "Yoni Kuta is assigned 4 points. It represents sexual aspects, including compatibility of intimate temperament."
      },
      {
        "key": "maitri",
        "label": "Maitri",
        "max_points": 5,
        "obtained_points": 5,
        "boy_value": "Mars",
        "girl_value": "Mars",
        "area_of_life": "Affection",
        "description": "Maitri (Graha Maitri) Kuta is assigned 5 points. It represents psychological disposition, mental qualities and affection between the couple."
      },
      {
        "key": "gana",
        "label": "Gana",
        "max_points": 6,
        "obtained_points": 6,
        "boy_value": "Deva",
        "girl_value": "Deva",
        "area_of_life": "Nature",
        "description": "Gana Kuta is assigned 6 points. It represents nature, temperament, longevity, wealth and love."
      },
      {
        "key": "bhakoot",
        "label": "Bhakoot",
        "max_points": 7,
        "obtained_points": 7,
        "boy_value": "Mesha",
        "girl_value": "Mesha",
        "area_of_life": "Love",
        "description": "Bhakoot (Rashi) Kuta is assigned 7 points. It represents children, wealth, comfort, good luck and growth of the family."
      },
      {
        "key": "nadi",
        "label": "Nadi",
        "max_points": 8,
        "obtained_points": 0,
        "boy_value": "Aadi",
        "girl_value": "Aadi",
        "area_of_life": "Health",
        "description": "Nadi Kuta is assigned 8 points, the most important of all. It represents temperament, health, and genetic compatibility for progeny."
      }
    ],
    "total_score": 28,
    "max_score": 36,
    "minimum_recommended_score": 18,
    "doshas": [
      "Nadi Dosha"
    ],
    "verdict": "Union is NOT Recommended",
    "verdict_reason": "due to Nadi Dosha"
  },
  "message": "successful",
  "is_error": false
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.