İçeriğe atla
Occult API
POST/api/astro/tithi_scan/1 kredi

Tithi yıl taraması

Tithi, kameri ayın otuzda biridir: Ay'ın Güneş'ten uzanımının 12 derece daha arttığı süre. Neredeyse tüm Hindu dini günleri tithilere göre tanımlanır ve tithiler takvim günleriyle örtüşmez: bir tithi yaklaşık on dokuz saat kadar kısa ya da yaklaşık yirmi altı saat kadar uzun olabilir; bu yüzden tek bir tithi çoğu zaman iki tarihe yayılır. Bu endpoint adı verilen bir tithiyi alır ve onun bir takvim yılı içindeki tüm tekrarlarını gerçek başlangıç ve bitiş anlarıyla döndürür. `tithi_number` 1 ile 30 arasındadır: 1-15 Shukla Pratipada'dan Purnima'ya, 16-29 Krishna Pratipada'dan Chaturdashi'ye kadardır, 30 ise Amavasya'dır. `year` yerel takvim yılıdır; bunun hangi yerel yıl olduğunu `timezone_as_float` belirler (IST için 5.5). Koordinat gerekmez, çünkü bir tithi Dünya'nın her yerinde aynı anda başlar ve biter. Yanıt `{year, tithi_number, rows}` biçimindedir; `rows`, UTC ISO zaman damgalarıyla `{start, end}` öğelerinden oluşan kronolojik bir listedir. Belirli bir tithi her kameri ayda bir kez geldiği için liste genellikle on iki veya on üç girişten oluşur. Aralıklar aradaki gün doğumlarında bölünmez; bu yüzden iki takvim gününe yayılan bir tithi tek satır olarak döner.

https://api.occultapi.com/api/astro/tithi_scan/
İsteği deneyin

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ı

AlanTürZorunluNotlar
timezone_as_floatnumber (double)zorunlu

Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir.

tithi_numberintegerzorunlu

min 1 · max 30

yearintegerzorunlu

Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı.

min 1800 · max 2400

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/tithi_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timezone_as_float":5.5,"tithi_number":1,"year":2026}'

Yanıt

{
  "data": {
    "year": 2026,
    "tithi_number": 1,
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T20:45:19+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-18T11:28:41+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T23:23:24+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-18T08:41:36+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T16:11:46+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T23:01:51+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-15T06:21:58+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T15:12:30+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-12T02:17:22+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T16:02:05+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-10T08:31:14+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-10T03:17:14+00:00"
      }
    ]
  },
  "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.