curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Doşa, doğum haritasındaki belirli bir olumsuz durumdur — klasik metinlerin çoğunlukla evlilik, sağlık ya da soy açısından sorun kaynağı saydığı, adı konmuş bir gezegen dizilimi. Bu endpoint doğum anı ve yerinden sekiz doşayı kontrol eder; sonuçları yalın biçimde ya da gösterime hazır açıklama metinleri olarak döndürebilir. İki kullanım yolu vardır. Tekil anahtarlar (`kala_sarpa`, `manglik`, `pitru_dosha` vb.) kodunuzda doğrudan kullanabileceğiniz yapılandırılmış sonuçlar döndürür. `get_dosha_details` ise tüm doşaları, İngilizce doşa adlarıyla anahtarlanmış biçimlendirilmiş HTML paragrafları olarak döndürür; rapor oluşturuyorsanız ihtiyacınız olan budur. Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata ve Shrapit'i kapsar, Ganda Moola'yı kapsamaz. Metni kendiniz oluşturmak isterseniz `get_dosha_resources` alttaki metin derlemini verir. Boolean ve yapılandırılmış istek alanlarının tümü, onları kullanmayan anahtarlar için bile serializer tarafından zorunlu tutulur. `manglik_reference_planet` bir gezegen indeksidir (0 Güneş, 1 Ay, 2 Mars, 3 Merkür, 4 Jüpiter, 5 Venüs, 6 Satürn, 7 Rahu, 8 Ketu). Motorun kendi varsayılanı olan yükselenden ölçme seçeneği API üzerinden seçilemez, çünkü alan tam sayı olarak tanımlanmıştır. Bu endpoint'te UTC farkı alanının adı `timezone_as_float` değil, `timezone`'dur.
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| apply_exceptions | boolean | zorunlu | |
| date_time | 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 ve 200 koduyla bir önceki günün sonucunu döndürebilir. '2026-09-01T06:00:00Z' ile '2026-09-01 06:00:00' farklı anlardır ve farklı sonuç verir. BİÇİM kısıtı. 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). |
| include_2nd_house | boolean | zorunlu | |
| include_lagna_house | boolean | zorunlu | |
| keys | array | zorunlu | Döndürülecek hesaplamaların adlarını içeren liste. Bu endpoint'in anahtar tablosuna bakın; tanınmayan bir ad varsa isteğin tamamı reddedilir. Kaç anahtar isterseniz isteyin bir çağrı bir kredi tutar; bu yüzden birkaç ayrı çağrı yapmak yerine ihtiyacınız olan her şeyi tek seferde isteyin. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsString dizisi. 'manglik' için manglik_reference_planet, include_lagna_house, include_2nd_house ve apply_exceptions; 'ganda_moola' için moon_star; 'get_dosha_details' için date_time ve geopos gerekir. |
| 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 -90 · max 90 |
| 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 |
| manglik_reference_planet | integer | zorunlu | |
| moon_star | string | zorunlu | Anlam olarak 1-27 arası bir nakshatra NUMARASIDIR (Ganda Moola nakshatraları: 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Bu tür uyuşmazlığı giderilene kadar işe yarayan bir kabul edilen değerler listesi yayımlanamaz. |
| timezone | number (double) | zorunlu | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30). timezone_as_float ile aynı anlama gelir; diğer endpoint'ler aynı alanı farklı bir adla kullanır. |
İstediğiniz hesaplamaları keys içinde tek tek sayın; yalnızca onlar hesaplanır. Bilinmeyen tek bir anahtar bile isteğin tamamını reddettirir. Kaç anahtar isterseniz isteyin ücret 1 kredi olur; bu yüzden hepsini tek istekte toplayın.
| Anahtar | Gereken ek alanlar | Açıklama | |
|---|---|---|---|
| ganda_moola | moon_star | Ganda Moola: doğum yıldızının altı geçiş nakshatrasından (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati) biri olup olmadığı. `moon_star` alanında 1–27 arası nakshatra numarasını alıp boolean döndürmesi amaçlanmıştır; ancak alan string olarak tanımlıyken karşılaştırma listesi tam sayılardan oluşur. Bu yüzden şu hâliyle bu anahtar her girdi için false döndürür. | |
| get_dosha_details | date_time, geopos | Açıklamalı yedi doşanın tümü tek seferde değerlendirilir ve metne dökülür: İngilizce doşa adlarıyla anahtarlanmış bir nesne — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha ve Shrapit Dosha. Değerler, doşanın haritada bulunup bulunmadığını ve ne anlama geldiğini anlatan HTML parçalarıdır. Ganda Moola dahil değildir. `date_time` ve yer bilgisi gerekir. | |
| get_dosha_resources | — | Doşa açıklama metinlerinin tam derlemi: doşa adlarıyla ('kala_sarpa', 'manglik', 'pitru', 'ghata' vb.) anahtarlanmış ve her birinin altında İngilizce paragraflardan oluşan bir liste bulunan bir nesne. Listenin ilk öğesi 'böyle bir doşa yok' metnidir; sonraki öğeler ilgili eve veya türe karşılık gelir. Hazır birleştirilmiş HTML yerine kendi metninizi oluşturmak için kullanın. | |
| ghata | — | Ghata doşası: Mars ile Satürn'ün aynı burçta bulunması. Tek bir boolean döndürür. | |
| guru_chandala_dosha | — | Guru Chandala: Jüpiter'in aynı burçta Rahu veya Ketu ile kavuşumu. [birleşim var mı, Jüpiter ikisinden daha güçlü mü] biçiminde iki öğeli bir liste döndürür. Kavuşum yoksa iki değer de false olur. | |
| kala_sarpa | — | Kala Sarpa doşası: yedi klasik gezegenin tümü, düğüm ekseninin bir tarafında Rahu ile Ketu arasına sıkışmışsa true olur. Tek bir boolean döndürür; türü (Ananta, Kulika, Vasuki vb.) Rahu'nun bulunduğu eve göre belirlenir. | |
| kalathra | — | Kalathra doşası, yani evlilik evinin zarar görmesi. Doğal malefiklerin hepsi — Güneş, Mars, Satürn, Rahu ve Ketu — yedinci evden sayıldığında 1., 2., 4., 7., 8. veya 12. evdeyse true olur. Tek bir boolean döndürür; beş malefikin tamamının koşulu sağlaması gerektiğinden nadiren true çıkar. | |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik ya da Mangal doşası: Mars'ın, `manglik_reference_planet` noktasından sayıldığında evliliği olumsuz etkileyen evlerden birinde olup olmadığı. [manglik mi, bir iptal kuralı geçerli mi, eşleşen iptal kurallarının numaraları] biçiminde üç öğeli bir liste döndürür. Kontrol edilen evler 4., 7., 8. ve 12. evlerdir; `include_2nd_house` true ise 2. ev, `include_lagna_house` true ise 1. ev de eklenir. İptal kuralları yalnızca `apply_exceptions` true olduğunda değerlendirilir. | |
| pitru_dosha | — | Pitru doşası, yani soy hattının zarar görmesi. [true veya false, tetiklenen kuralların numaraları] biçiminde iki öğeli bir liste döndürür. Beş kural sırayla kontrol edilir: 9. evde bir ışık (Güneş veya Ay) ya da Rahu, 4. evde Ketu, Mars veya Satürn'ün olumsuz etkisindeki Güneş/Ay/Rahu/Ketu, 2., 5., 9. veya 12. evde Merkür, Venüs ve Rahu'nun bir araya gelmesi ve Güneş ya da Ay'ın bir düğümle kavuşumu. | |
| shrapit | — | Shrapit doşası: Satürn ile Rahu'nun aynı burçta bulunması. Tek bir boolean döndürür. |