Giriş

Panchang ve beş unsuru, kundli ve D2'den D60'a varga haritaları, otuz dasha sistemi, yogalar ve doshalar, muhurat aralıkları, ashtakavarga, gezegen gücü, kundli uyumu, on üç sistemde numeroloji ve bayramlarıyla birlikte on bir bölgesel takvim.

Her şey isteğinizdeki tarih, saat ve koordinatlara göre hesaplanır; önceden hesaplanmış bir almanak kullanılmaz. Endpoint'lerin neredeyse tamamı yazılı yorum değil, sayılar ve klasik sınıflandırmalar döndürür. Yazılı metin döndüren birkaç istisna var: sohbet endpoint'i, genel öngörüler, rashifal ve PDF raporları.

API'nin büyük kısmı beklediğiniz gibi çalışır. Aşağıdaki üç konu ise farklıdır ve insanlara en çok zaman kaybettiren de bunlardır.

Birçok endpoint, hangi hesaplamaları istediğinizi belirten bir keys dizisi alır. /api/astro/panchanga/ adresine yapılan tek bir çağrı, ne istediğinize göre 57 farklı sonuçtan herhangi birini döndürebilir.

Hepsinin fiyatı aynı: tek kredi. İhtiyacınız olan her şeyi tek çağrıda istemek pahalı değil, ucuz yoldur. Asıl hata, beş anahtar için aynı endpoint'i beş kez çağırmaktır. Her endpoint sayfası geçerli anahtarlarını listeler. Referansta yola göre olduğu kadar hesaplamaya göre de arama yapabilirsiniz; böylece hangi endpoint'te olduğunu bilmeden aradığınız özelliği bulursunuz.

{
  "date_time": "2026-09-16T06:00:00+05:30",
  "latitude": 26.9124,
  "longitude": 75.7873,
  "timezone_as_float": 5.5,
  "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
}

Her JSON yanıtı aynı dört alanı içerir. is_error değerine göre dallanın, sonucu data alanından okuyun, bir sorun çıkarsa message değerini gösterin. Bu mesaj “geçersiz istek” demekle yetinmez, hatalı alanları tek tek adıyla belirtir.

{
  "data":     { ... },        // the result; shape varies by endpoint
  "status":   200,
  "is_error": false,
  "message":  "successful"
}

Başarılı her çağrı bir kredidir; iki PDF raporu ve sohbet endpoint'i 25 kredidir. 4xx, 5xx ya da zaman aşımı hiçbir şeye mal olmaz: kredi, hesaplama başlamadan önce ayrılır ve hesaplama sorunsuz tamamlanmazsa geri bırakılır. Hata ayıklama sırasında bozuk bir entegrasyon bakiyenizi eritemez.

Erişim aylık ya da yıllık bir planla sağlanır. Planın kotası her ay sıfırlanır ve kullanmadığınız çağrılar sonraki aya devretmez. Kullanıcı başına ücret yoktur ve istediğiniz zaman iptal edebilirsiniz. Her yanıt X-Credits-Charged ve X-Credits-Remaining başlıklarını taşır; böylece bakiyenizi ikinci bir çağrı yapmadan izleyebilirsiniz.

Konumlar NASA JPL efemeris verilerinden gelir: veri setinin tamamı, 735 sabit yıldız; MS 500 ile 2999 yılları arasında test edildi. Sunucu tarafındaki medyan yanıt süresi 62 ms'dir. Bu değer seçilmiş tek bir örnekten değil, yayımlanan tüm örneklerden ölçülmüştür. Yavaş endpoint'ler derin taramalardır ve dokümanlarda öyle belirtilir.

Hint gelenekleri ayanamsa konusunda gerçekten ayrışır. Bu yüzden API 48 ayanamsa sunar ve her birini derece, dakika ve saniye düzeyinde düzeltmenize izin verir. Hangisini seçeceğinize ve bunu kullanıcılarınıza nasıl açıklayacağınıza siz karar verirsiniz. Birini seçip “doğrusu bu” diyerek bu kararı sizin yerinize vermiyoruz.

Bu bir hesaplama aracıdır, danışmanlık değil. Döndürdüğü hiçbir şey tıbbi, hukuki ya da finansal tavsiye değildir. Yazılı metin döndüren birkaç endpoint dışında yorum metni de yazmaz. Ürününüz bu sonuçlara dayanarak öneride bulunuyorsa, bu sizin editoryal kararınızdır. Çıktıyla neler yapabileceğinizi öğrenmek için lisansa bakın.

Temel URL https://api.occultapi.com. Düz HTTP'nin yanı sıra şunlar da var: kendi anahtarınızla gerçek çağrılar yapan bir playground (başarısız çağrı ücretsizdir), bir Postman koleksiyonu, istemci üretmek için bir OpenAPI 3.1 tanımı ve bir yapay zekâ asistanının API'yi doğrudan çağırabilmesi için bir MCP sunucusu.