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

Karana taraması

Karana, tithinin yarısıdır — Ay'ın Güneş'ten uzaklaşmasının altı derecesi, yani yaklaşık on bir ila on üç saat. On bir karana vardır: kameri ay boyunca her biri sekiz kez tekrarlanan yedi hareketli karana ve her biri yalnızca bir kez görülen dört sabit karana. Bunlardan kaçınılanı, genellikle Bhadra diye anılan Vishti'dir. Bu endpoint, adı verilen bir karananın bütün bir takvim yılı içindeki tüm oluşumlarını bulur; böylece yılı gün gün taramadan 'bir sonraki Vishti ne zaman' listesi oluşturabilirsiniz. karana_name değerini alanın listesindeki yazımıyla (büyük/küçük harfe duyarlıdır), year ve timezone_as_float ile birlikte gönderin; UTC farkı, yerel yılın nerede başlayıp bittiğini belirler. Karana tamamen Ay'a bağlı bir nicelik olduğundan enlem veya boylam gerekmez. Yanıt {year, karana_name, rows} biçimindedir; rows, UTC cinsinden {start, end} zaman damgalarının kronolojik listesidir. Sabit bir karana yılda yaklaşık on iki satır, hareketli bir karana ise yüze yakın satır verir. Tek bir günün karanaları için bunun yerine /api/astro/panchanga/ endpoint'indeki karana_segments anahtarını kullanın.

https://api.occultapi.com/api/astro/karana_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
karana_namestringzorunlu
KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga
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.

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/karana_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"karana_name":"Kimstughna","timezone_as_float":5.5,"year":2026}'

Yanıt

{
  "data": {
    "year": 2026,
    "karana_name": "Kimstughna",
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T08:22:04+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-17T23:48:42+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T12:26:49+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-17T22:18:56+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T06:07:05+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T12:57:08+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-14T20:00:36+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T04:21:33+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-11T14:48:43+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T03:52:40+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-09T19:43:50+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-09T14:03:05+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.