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}'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.
| 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_KUGLER3Bü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 | BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChartBü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 | astrologicaldegreeBü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ı | addsubtractVarsayı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_bodiesString 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. truemeanbothVarsayı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ı | TrueMeanBü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ı |