İçeriğe atla
POST/api/astro/saptamsa/1 kredi

Saptamsa (D7)

Saptamsa, yedinci varga haritasıdır: her burç, her biri yaklaşık 4°17' olan yedi parçaya bölünür. Çocuklar ve soy için yorumlanır. /api/astro/planet-positions/ ile aynı düz yapıyı döndürür: gezegenler geleneksel sırayla bir liste hâlinde gelir ve her birinde `name`, boylam, burç, nakshatra, pada ve ev bulunur; ayrıca yükselen ile uygulanan ayanamsa da döner. Tarih ve yer bilgisi gönderin; `ayanamsa` varsayılan olarak LAHIRI'dir ve 48 ayanamsanın hepsi kabul edilir. Harita rotayla sabitlenmiştir; bu yüzden istek gövdesinde gönderilen `chart_name` dikkate alınmaz - bu endpoint yalnızca adını taşıdığı haritayı döndürebilir. Diğer 24 bölüm için /api/astro/chart/ endpoint'ini kullanın.

https://api.occultapi.com/api/astro/saptamsa/
İ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ı

AlanTürZorunluNotlar
chart_namestringzorunlu
datetimestring (date-time)zorunlu

Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur. date_time ile aynı anlama gelir; diğer endpoint'ler aynı alanı farklı bir adla kullanır.

latitudenumber (double)zorunlu

Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin.

min -89.9 · max 89.9

longitudenumber (double)zorunlu

Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer.

min -180 · max 180

aberrationbooleanisteğe bağlı
apply_correctionbooleanisteğe bağlı
ascendant_posstringisteğe bağlı
cuspstartend
ayanamsastringisteğe bağlı
background_colorstringisteğe bağlı

SVG arka planının hex rengi.

chart_stylestringisteğe bağlı

render='svg' olduğunda kullanılacak diyagram stili. 'north', evlerin sabit kalıp burçların döndüğü baklava düzenidir; 'south' ise burçların sabit kalıp evlerin döndüğü ızgara düzenidir.

northsouth
correction_degintegeristeğe bağlı

min 0

correction_directionstringisteğe bağlı
addsubtract
correction_minintegeristeğe bağlı

min 0 · max 59

correction_secintegeristeğe bağlı

min 0 · max 59

extended_bodiesarrayisteğe bağlı

Dahil edilecek cisim grupları: 'asteroids', 'planetary_moons', 'fictitious_bodies'.

label_stylestringisteğe bağlı

Gezegen etiketlerinin biçimi: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) veya 'symbol' (☉, ☽, ...).

englishsanskritsymbol
line_colorstringisteğe bağlı

Harita ızgara çizgilerinin hex rengi.

notationstringisteğe bağlı
astrologicaldegree
nutationbooleanisteğe bağlı
planet_colorstringisteğe bağlı

Gezegen etiketlerinin hex rengi, ör. '#111827'. Varsayılan: temanın kendi rengi.

rahustringisteğe bağlı

Dahil edilecek düğüm türü. 'true' yalnızca gerçek düğümleri, 'mean' yalnızca ortalama düğümleri, 'both' ikisini birden döndürür.

truemeanboth
refractionbooleanisteğe bağlı
renderstringisteğe bağlı

Çizilmiş harita diyagramını (bkz. chart_style) ve onun geometrisini de almak için 'svg' olarak ayarlayın. Bu alanı hiç göndermezseniz yanıt değişmez.

nonesvg
show_degreesbooleanisteğe bağlı

Her cismin burç içindeki derecesini etiketinin yanında gösterir.

sign_colorstringisteğe bağlı

Burç numaralarının/kısaltmalarının hex rengi.

svg_sizeintegeristeğe bağlı

Kare SVG viewBox alanının piksel cinsinden genişliği ve yüksekliği.

min 100 · max 2000

themestringisteğe bağlı
lightdark
true_meanstringisteğe bağlı
TrueMean
use_28_nakshatrasbooleanisteğe bağlı

Örnek istek

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

Yanıt

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 220.66583333333335,
        "latitude": 0,
        "nakshatra": "Anooraadha",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Scorpio",
        "house": 2
      },
      {
        "name": "moon",
        "longitude": 10.344444444444443,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Aries",
        "house": 7
      },
      {
        "name": "mars",
        "longitude": 194.22305555555556,
        "latitude": 0.535,
        "nakshatra": "Swaati",
        "pada": 3,
        "kakshya": "sun",
        "zodiac_name": "Libra",
        "house": 1
      },
      {
        "name": "mercury",
        "longitude": 249.55444444444444,
        "latitude": 1.574,
        "nakshatra": "Moola",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Sagittarius",
        "house": 3
      },
      {
        "name": "jupiter",
        "longitude": 46.30361111111111,
        "latitude": 0.529,
        "nakshatra": "Rohini",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Taurus",
        "house": 8
      },
      {
        "name": "venus",
        "longitude": 172.69083333333333,
        "latitude": -3.391,
        "nakshatra": "Hasta",
        "pada": 4,
        "kakshya": "moon",
        "zodiac_name": "Virgo",
        "house": 12
      },
      {
        "name": "saturn",
        "longitude": 286.1286111111111,
        "latitude": -2.651,
        "nakshatra": "Sravanam",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Capricorn",
        "house": 4
      },
      {
        "name": "northtruenode",
        "longitude": 338.9608333333333,
        "latitude": 0,
        "nakshatra": "Uttaraabhaadra",
        "pada": 2,
        "kakshya": "mars",
        "zodiac_name": "Pisces",
        "house": 6
      },
      {
        "name": "southtruenode",
        "longitude": 158.96083333333334,
        "latitude": 0,
        "nakshatra": "Uttara Phalguni",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Virgo",
        "house": 12
      },
      {
        "name": "uranus",
        "longitude": 289.96722222222223,
        "latitude": -0.154,
        "nakshatra": "Sravanam",
        "pada": 3,
        "kakshya": "Mercury",
        "zodiac_name": "Capricorn",
        "house": 4
      },
      {
        "name": "neptune",
        "longitude": 216.02944444444444,
        "latitude": -1.412,
        "nakshatra": "Anooraadha",
        "pada": 1,
        "kakshya": "jupiter",
        "zodiac_name": "Scorpio",
        "house": 2
      },
      {
        "name": "pluto",
        "longitude": 154.95222222222225,
        "latitude": -4.3,
        "nakshatra": "Uttara Phalguni",
        "pada": 3,
        "kakshya": "jupiter",
        "zodiac_name": "Virgo",
        "house": 12
      }
    ],
    "ascendant": {
      "longitude": 205.3144444444445,
      "zodiac_name": "Libra",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.