Alan biçimleri

• URL: temel adres https://api.occultapi.com, ardından yol, listede yazdığı gibi ve sonunda eğik çizgiyle.
  Doğru: /api/astro/tithi/, /api/astro/dasha/vimshottari/, /api/festivals/.
  Yanlış: /api/astro/tithi, /astro/tithi/, /api/astro/Tithi/.
• Kimlik doğrulama: anahtarınız X-API-Key başlığında, her POST isteğinde de Content-Type: application/json.
• Metot: JSON gövdeli POST. Az sayıdaki GET sorgusu (yer arama, ayanamsa değeri, shalaka tabloları ve doğal afet verileri) girdi alıyorsa bunları sorgu parametresi olarak alır.
  Doğru: JSON gövdeli POST /api/astro/panchanga/; GET /api/astro/geocode/?address=Jaipur.

• date_time: hesaplanan an (doğum haritası için doğum anı); UTC farkı ya da sonda Z içeren ISO 8601 biçiminde.
  Doğru: "1990-08-15T10:30:00+05:30", "2026-09-01T00:30:00Z".
  Yanlış: "1990-08-15 10:30:00" (saat farkı yok: endpoint'lerin çoğu bunu UTC+05:30, birkaçı UTC olarak okur), "15/08/1990 10:30 AM".
• datetime: aynı değer, farklı bir adla. /api/astro/chart/, varga haritası yolları ve /api/astro/planet-positions/ bu yazımı ister; dasha yolları ikisini de kabul eder.
• date ve time: yalnızca /api/astro/date_time/ içindir. Bu endpoint yerel saati ve koordinatları alır, o tarih için saat farkını içeren bir zaman damgası döndürür.
  Doğru: "1990-08-15" ve "10:30:00".
• year, month, day: bir endpoint bunları istiyorsa (numeroloji, takvimler, yıllık taramalar) düz tam sayı olarak.
  Doğru: 1990, 8, 15.

• latitude / longitude: ondalık derece. Kuzey ve doğu pozitif, güney ve batı negatiftir.
  Doğru: 26.9124, 75.7873 (Jaipur); 40.7128, -74.006 (New York).
  Yanlış: "26°54′N", metin değerler ya da New York için 74.006 (unutulan eksi, şehri Çin'e taşır).
• timezone_as_float: o yerde o tarihte geçerli olan UTC farkı (yaz saati dahil); -12 ile 14 arasında, saat cinsinden bir sayı.
  Doğru: 5.5 (Hindistan), -4 (yaz saatinde New York), 5.75 (Nepal).
  Yanlış: "+05:30", "Asia/Kolkata", "IST".
• Aynı saat farkı bazı endpoint'lerde başka adlarla geçer: timezone (örneğin /api/astro/dosha/ ve /api/astro/strength/), tz (/api/astro/transit/) ve time_zone (/api/astro/celestial/). Endpoint hangi adı listeliyorsa onu gönderin.

• ayanamsa (sidereal endpoint'ler): büyük/küçük harf duyarsız bir ayanamsa adı; varsayılan LAHIRI. /api/astro/chart/ bu alanı zorunlu tutar.
  Doğru: LAHIRI, KRISHNAMURTI, RAMAN, TRUE_CITRA.
  Yanlış: "kp-newcomb", "Lahiri ayanamsa". /api/astro/chart/ üzerinde bilinmeyen bir ad 400 döndürür.
• /api/astro/western/ ve /api/astro/return/ yollarında ayanamsa varsayılan olarak TROPICAL değerini alır; sidereal konumlar için bir ayanamsa adı gönderin.
• ayanamsa alanı olmayan endpoint'ler Lahiri ile hesaplar. /api/astro/prashna/jamakkol/ kendi küçük harfli listesini kullanır: lahiri, true_citra, krishnamurti, raman.

• keys: endpoint'in anahtar tablosundaki adları birebir içeren bir JSON dizisi.
  Doğru: /api/astro/panchanga/ üzerinde ["tithi", "vaara", "rahu_kaalam"].
  Yanlış: "tithi,vaara" (tek bir metin), "Tithi", "rahu_kaal".
• Bazı anahtarlar, anahtar tablosunda belirtilen ek bir alan ister: /api/astro/numerology/ üzerindeki phone_number anahtarı bir phone_number değeri gerektirir.
• Referansında anahtar tablosu olmayan endpoint'ler (örneğin /api/astro/tithi/ ya da /api/astro/rahu-kaal/) her zaman aynı hesaplamayı yapar; keys göndermeniz gerekmez.

• /api/astro/chart/ üzerindeki chart_name: büyük/küçük harf duyarlı PascalCase. Tek çağrıda birden fazla harita almak için dizi gönderin.
  Doğru: "RashiChart", ["RashiChart", "NavamsaChart", "DasamsaChart"].
  Yanlış: "rashi", "D9", "Navamsa".
• notation: küçük harfle degree (ondalık derece) ya da astrological (burç, derece, dakika, saniye).
• Ay düğümü: harita yollarında rahu (varsayılan true; ayrıca mean ya da both), dasha ve Jaimini yollarında node (varsayılan true; ayrıca mean), Human Design ve Prashna'da node_type (varsayılan mean; yalnızca /api/astro/prashna/ üzerinde zorunludur).
• /api/astro/western/house-cusps/ üzerindeki house_system: küçük harfli, alt çizgiyle ayrılmış.
  Doğru: placidus (varsayılan), whole_sign, equal, koch, porphyry, regiomontanus, campanus, topocentric.
  Yanlış: "whole-sign", "W".
• Rashifal yollarındaki rashi: İngilizce burç adları.
  Doğru: aries, taurus, … pisces.
• /api/astro/numerology/ üzerindeki system: chaldean (varsayılan), pythagorean, chinese ya da vedic. Her sistemin kendi anahtar seti vardır.
• /api/astro/tarot/spread/ üzerindeki spread: three_card (varsayılan), one_card, celtic_cross, horseshoe, relationship ya da situation.
• /api/astro/numerology/angel/ üzerindeki sequence: görülen sayı, metin olarak.
  Doğru: "1111", "444".
  Yanlış: 1111 (sayı olarak).
• Dasha zaman çizelgelerindeki levels: 1 ile 4 arası, varsayılan 3. 1 yalnızca mahadashaları verir, 2 antardashaları, 3 pratyantardashaları ekler.

Her yol eğik çizgiyle biter. Eğik çizgi yoksa sunucu, eğik çizgili URL'ye yönlendiren bir 301 döndürür. Çoğu HTTP istemcisi bu yönlendirmeyi gövdeyi göndermeden GET olarak izler ve çağrı başarısız olur. Yolun yazımını birebir kopyalayın: bazıları kısa çizgi (/api/astro/rahu-kaal/), bazıları alt çizgi (/api/astro/monthly_panchang/) kullanır ve birkaçı /api/astro/ dışında yer alır (/api/festivals/, /api/vrat-upavas/).

• /docs/agent-gotchas — Astrolojiye özgü tuzaklar
• /docs/agent-tasks — Ajan görev kopya kâğıdı