POST/api/astro/chart/1 kredi

Doğum haritası

Temel harita endpoint'i: belirli bir an ve yer için gezegen konumları, ev bölümleri ve yükselen. Sıradan bir doğum haritası için Rashi haritasını (D-1), ya da otuzu aşkın varga haritasından herhangi birini — Navamsa, Dasamsa, Dwadasamsa, Shashtyamsa vb. — adıyla isteyin. Tek çağrıda birkaç harita almak için ad dizisi gönderin; yanıt harita adlarıyla anahtarlanır. Her harita üç blok döndürür. `celestial` cisim adlarıyla anahtarlanır (sun, moon, … northtruenode) ve her cisim için boylam, enlem, nakshatra ve pada, kakshya, burç adı ve ev numarası verir. `houses` 1'den 12'ye anahtarlanır ve her evin `start`, `cusp` ve `end` değerlerini içerir. `ascendant` yükselen dereceyi ve burcunu verir. `notation` tüm yanıttaki birimleri belirler: ondalık derece için 'degree', burç artı derece, dakika ve saniye için 'astrological'. Hassas ayarlar isteğe bağlı alanlardadır. `ayanamsa` sideral tanımı seçer; `apply_correction` ile birlikte `correction_deg`, `correction_min`, `correction_sec` ve `correction_direction` bu değeri elle kaydırır. `rahu` gerçek düğümleri, ortalama düğümleri ya da ikisini birden seçer. `extended_bodies` asteroitleri, Uranyen kurgusal cisimleri veya gezegen uydularını ekler; efemeris dosyası bulunmayanlar sessizce atlanır. `ascendant_pos`, yükselenin ev cusp'ında mı, başlangıcında mı, sonunda mı okunacağını belirler — 'start' ve 'end' dışındaki her değerin, yazım hataları da dahil, hiçbir uyarı vermeden cusp'a geri döndüğüne dikkat edin. Bu endpoint'te tarih alanının adı `date_time` değil, `datetime`'dır. İSTEĞE BAĞLI SVG ÇİZİMİ. render alanını 'svg' yaparsanız yanıta, yukarıdaki dört alanın yerine değil yanına iki alan daha eklenir. `layout` geometridir — her ev veya burç hücresinin çokgen köşeleri, etiket konumu ve içinde hangi cisimlerin bulunduğu — böylece kendi diyagramınızı React, Canvas, Flutter veya SwiftUI ile çizebilirsiniz. `svg` ise aynı geometriden üretilmiş, doğrudan sayfaya konabilecek işaretlemedir. chart_style, Kuzey Hint (baklava, sabit evler, dönen burçlar) ya da Güney Hint (sabit burç ızgarası, dönen evler) stilini seçer; svg_size, theme, label_style, show_degrees ve dört *_color alanı çizimi ayarlar. Bu alanların hepsi varsayılan olarak kapalıdır; render alanını içermeyen bir istek hiç etkilenmez — yanıt her zamanki gibidir.

https://api.occultapi.com/api/astro/chart/

İsteği deneyin

Doğum haritası çıktısı bir arayüzde — Bu endpoint'in verileri, canlı bir arayüzde. Değerleri API verir; ekran düzenini siz kurarsınız.

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
ascendant_pos	string	zorunlu	`cuspstartend` 'start' evin başlangıcını, 'end' evin sonunu kullanır; DİĞER HER değer - 'cusp' değerinin kendisi ve her türlü yazım hatası dahil - else dalına düşer ve ev cusp'ını kullanır. Yani fiili varsayılan 'cusp' değeridir ve yazım hataları hata vermeden sessizce geçer. Büyük/küçük harfe duyarlıdır.
ayanamsa	string	zorunlu	`FAGAN_BRADLEYLAHIRIDELUCERAMANUSHASHASHIKRISHNAMURTIDJWHAL_KHULYUKTESHWARJN_BHASINBABYL_KUGLER1BABYL_KUGLER2BABYL_KUGLER3` Büyük/küçük harfe DUYARSIZ - arama name.upper ile yapılır. /api/astro/ayanamsa_value/ endpoint'inin aksine 'USER' burada reddedilMEZ. Bilinmeyen bir değer 400 "Undefined ayanamsa: <name>" döndürür. apply_correction=true değerinin bu seçimi geçersiz kıldığına ve iç modu USER'a çevirdiğine dikkat edin.
chart_name	string	zorunlu	`BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChart` Büyük/küçük harfe duyarlıdır; tam olarak listede yazıldığı gibi girilmelidir. Tek bir ad gönderin ya da tek çağrıda birkaç harita almak için bir dizi gönderin - bu durumda yanıt harita adlarıyla anahtarlanır. Bilinmeyen bir ad 400 döndürür.
datetime	string (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. BİÇİM kısıtı, enum değil. DRF DateTimeField: yalnızca ISO-8601 (DRF varsayılan giriş biçimleri), ör. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" veya "2026-09-01 06:00:00" (saat dilimi yoksa UTC varsayılır). Bu endpoint'te alanın adının `date_time` değil, `datetime` olduğuna dikkat edin.
latitude	number (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 -180 · max 180
longitude	number (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
notation	string	zorunlu	`astrologicaldegree` Büyük/küçük harfe duyarlı, küçük harfle. 'astrological' burç/derece/dakika/saniye bileşenlerini, 'degree' ise ham ondalık dereceyi döndürür. Başka bir değer 400 "Invalid notation: <x>" döndürür.
aberration	boolean	isteğe bağlı
apply_correction	boolean	isteğe bağlı
background_color	string	isteğe bağlı	SVG arka planının hex rengi.
chart_style	string	isteğ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_deg	integer	isteğe bağlı	min 0
correction_direction	string	isteğe bağlı	`addsubtract` Varsayılan: 'add'. Yalnızca apply_correction=true olduğunda ve correction_deg/min/sec değerlerinden en az biri sıfır olmadığında anlamlıdır.
correction_min	integer	isteğe bağlı	min 0 · max 59
correction_sec	integer	isteğe bağlı	min 0 · max 59
extended_bodies	array	isteğe bağlı	Dahil edilecek cisim grupları: 'asteroids', 'planetary_moons', 'fictitious_bodies'. `asteroidsplanetary_moonsfictitious_bodies` String dizisi, varsayılan []. 'asteroids' şu cisimleri ekler: chiron, pholus, ceres, pallas, juno, vesta. 'fictitious_bodies' şunları ekler: cupido, hades, zeus, kronos, apollon, admetos, vulkanus, poseidon, selena. 'planetary_moons' şunları ekler: phobos, deimos, io, europa, ganymede, callisto, titan, triton, charon. Efemeris dosyası eksik olan cisimler yanıttan sessizce çıkarılır.
label_style	string	isteğe bağlı	Gezegen etiketlerinin biçimi: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) veya 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	isteğe bağlı	Harita ızgara çizgilerinin hex rengi.
nutation	boolean	isteğe bağlı
planet_color	string	isteğe bağlı	Gezegen etiketlerinin hex rengi, ör. '#111827'. Varsayılan: temanın kendi rengi.
rahu	string	isteğ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` Varsayılan: 'true'. 'true' yalnızca gerçek düğümleri, 'mean' yalnızca ortalama düğümleri döndürür; 'both' dördünü birden döndürür.
refraction	boolean	isteğe bağlı
render	string	isteğ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_degrees	boolean	isteğe bağlı	Her cismin burç içindeki derecesini etiketinin yanında gösterir.
sign_color	string	isteğe bağlı	Burç numaralarının/kısaltmalarının hex rengi.
svg_size	integer	isteğe bağlı	Kare SVG viewBox alanının piksel cinsinden genişliği ve yüksekliği. min 100 · max 2000
theme	string	isteğe bağlı	`lightdark`
true_mean	string	isteğe bağlı	`TrueMean` Büyük/küçük harfe DUYARLI, baş harfi büyük. Varsayılan: 'Mean'. Gerçek ya da ortalama gezegen konumlarını seçer (görünür konumlar yerine gerçek konumlar).
use_28_nakshatras	boolean	isteğe bağlı

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/chart/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_name":"NavamsaChart","datetime":"2026-04-09T15:35:00+05:30","longitude":75.76861133842026,"latitude":26.849874414615,"notation":"degree","ayanamsa":"lahiri","ascendant_pos":"cusp","rahu":"true","true_mean":"Mean","refraction":false,"apply_correction":false,"correction_direction":"add","correction_deg":0,"correction_min":0,"correction_sec":0}'

Yanıt

{
  "data": {
    "NavamsaChart": {
      "celestial": {
        "sun": {
          "longitude": 318.0675,
          "latitude": 0,
          "nakshatra": "Satabhishak",
          "pada": 4,
          "kakshya": "venus",
          "zodiac_name": "Aquarius",
          "house": 8
        },
        "moon": {
          "longitude": 150.3425,
          "latitude": -4.343,
          "nakshatra": "Uttara Phalguni",
          "pada": 2,
          "kakshya": "saturn",
          "zodiac_name": "Virgo",
          "house": 3
        },
        "mercury": {
          "longitude": 74.3125,
          "latitude": -2.291,
          "nakshatra": "Aardra",
          "pada": 3,
          "kakshya": "sun",
          "zodiac_name": "Gemini",
          "house": 12
        },
        "venus": {
          "longitude": 159.8475,
          "latitude": -0.081,
          "nakshatra": "Uttara Phalguni",
          "pada": 4,
          "kakshya": "mars",
          "zodiac_name": "Virgo",
          "house": 3
        },
        "mars": {
          "longitude": 139.1825,
          "latitude": -1.01,
          "nakshatra": "Poorva Phalguni",
          "pada": 2,
          "kakshya": "Mercury",
          "zodiac_name": "Leo",
          "house": 2
        },
        "jupiter": {
          "longitude": 19.82499999999999,
          "latitude": 0.377,
          "nakshatra": "Bharani",
          "pada": 2,
          "kakshya": "Mercury",
          "zodiac_name": "Aries",
          "house": 10
        },
        "saturn": {
          "longitude": 201.275,
          "latitude": -2.136,
          "nakshatra": "Visaakha",
          "pada": 1,
          "kakshya": "Mercury",
          "zodiac_name": "Libra",
          "house": 4
        },
        "uranus": {
          "longitude": 314.28,
          "latitude": -0.169,
          "nakshatra": "Satabhishak",
          "pada": 3,
          "kakshya": "sun",
          "zodiac_name": "Aquarius",
          "house": 8
        },
        "neptune": {
          "longitude": 164.6175,
          "latitude": -1.31,
          "nakshatra": "Hasta",
          "pada": 2,
          "kakshya": "sun",
          "zodiac_name": "Virgo",
          "house": 3
        },
        "pluto": {
          "longitude": 10.007499999999991,
          "latitude": -3.973,
          "nakshatra": "Ashwini",
          "pada": 4,
          "kakshya": "mars",
          "zodiac_name": "Aries",
          "house": 10
        },
        "northtruenode": {
          "longitude": 304.65,
          "latitude": 0,
          "nakshatra": "Dhanishtha",
          "pada": 4,
          "kakshya": "jupiter",
          "zodiac_name": "Aquarius",
          "house": 8
        },
        "southtruenode": {
          "longitude": 124.65,
          "latitude": 0,
          "nakshatra": "Makha",
          "pada": 2,
          "kakshya": "jupiter",
          "zodiac_name": "Leo",
          "house": 2
        }
      },
      "houses": {
        "1": {
          "start": 118.24667529991994,
          "cusp": 133.24667529991996,
          "end": 148.24667529991996
        },
        "2": {
          "start": 148.24667529991996,
          "cusp": 163.24667529991996,
          "end": 178.24667529991996
        },
        "3": {
          "start": 178.24667529991996,
          "cusp": 193.24667529991996,
          "end": 208.24667529991996
        },
        "4": {
          "start": 208.24667529991996,
          "cusp": 223.24667529991993,
          "end": 238.24667529991993
        },
        "5": {
          "start": 238.24667529991993,
          "cusp": 253.24667529991993,
          "end": 268.2466752999199
        },
        "6": {
          "start": 268.2466752999199,
          "cusp": 283.2466752999199,
          "end": 298.2466752999199
        },
        "7": {
          "start": 298.2466752999199,
          "cusp": 313.2466752999199,
          "end": 328.2466752999199
        },
        "8": {
          "start": 328.2466752999199,
          "cusp": 343.2466752999199,
          "end": 358.2466752999199
        },
        "9": {
          "start": 358.2466752999199,
          "cusp": 13.246675299919922,
          "end": 28.24667529991992
        },
        "10": {
          "start": 28.24667529991992,
          "cusp": 43.24667529991992,
          "end": 58.24667529991993
        },
        "11": {
          "start": 58.24667529991993,
          "cusp": 73.24667529991993,
          "end": 88.24667529991993
        },
        "12": {
          "start": 88.24667529991993,
          "cusp": 103.24667529991991,
          "end": 118.24667529991994
        }
      },
      "ascendant": {
        "longitude": 133.24667529991996,
        "zodiac_name": "Cancer",
        "nakshatra": "Makha",
        "pada": 4
      },
      "ayanamsa_used": {
        "name": "LAHIRI",
        "corrected": false,
        "value_degrees": 24.224068,
        "formatted": "24°13'27\""
      }
    }
  },
  "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.