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

Nitya Yoga yıl taraması

Nitya Yoga, Güneş ve Ay'ın sideral boylamlarının toplamından elde edilen noktanın, çemberin yirmi yedi eşit bölümünden hangisine düştüğünü gösterir. Vishkambha'dan Vaidhriti'ye kadar yirmi yedi yoganın her biri bir günden biraz kısa sürer ve seçim astrolojisinde önemlidir: Vyatipata, Vaidhriti, Parigha, Vyaghata, Shoola, Ganda ve Atiganda'dan geleneksel olarak kaçınılır; Siddhi, Siddha, Shubha, Amrita sınıfı ve Sukarma yogaları ise tercih edilir. Bu endpoint tek bir yogayı adıyla alır ve bir takvim yılındaki tüm tekrarlarını döndürür. `yoga_name` büyük/küçük harfe duyarlıdır ve enum değeriyle birebir eşleşmelidir. `year` ve `timezone_as_float` kapsanacak yerel yılı belirler; yoga her yerde aynı anda değiştiği için koordinat gerekmez. İki boylamın toplamı her 22.6 saatte yaklaşık 13 derece 20 dakika ilerlediğinden her yoga yılda yaklaşık on dört veya on beş kez tekrarlanır. Yanıt `{year, yoga_name, rows}` biçimindedir; `rows`, UTC ISO zaman damgalarıyla `{start, end}` öğelerinden oluşan kronolojik bir listedir. Her çift, o yoganın gerçek başlangıç ve bitiş anıdır. Bu anlar gün doğumunda örnekleme yapılarak değil, Güneş ve Ay boylamlarının toplamı üzerinde ikiye bölme (bisection) yöntemiyle bulunur; bu yüzden sınırlar saniyenin kesirleri kadar hassastır.

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

yearintegerzorunlu

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

min 1800 · max 2400

yoga_namestringzorunlu
VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva

Örnek istek

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

Yanıt

{
  "data": {
    "year": 2026,
    "yoga_name": "Vishkambha",
    "rows": [
      {
        "start": "2026-01-04T20:17:27.999999+00:00",
        "end": "2026-01-05T17:17:16.999999+00:00"
      },
      {
        "start": "2026-01-30T11:28:35.999999+00:00",
        "end": "2026-01-31T08:03:35.999999+00:00"
      },
      {
        "start": "2026-02-24T22:56:20.999999+00:00",
        "end": "2026-02-25T19:58:43.999999+00:00"
      },
      {
        "start": "2026-03-22T10:11:35.999999+00:00",
        "end": "2026-03-23T06:52:06.999999+00:00"
      },
      {
        "start": "2026-04-17T01:51:55.999999+00:00",
        "end": "2026-04-17T22:15:28.999999+00:00"
      },
      {
        "start": "2026-05-12T17:49:31.999999+00:00",
        "end": "2026-05-13T15:24:49.999999+00:00"
      },
      {
        "start": "2026-06-07T04:31:57.999999+00:00",
        "end": "2026-06-08T03:58:13.999999+00:00"
      },
      {
        "start": "2026-07-02T11:09:21.999999+00:00",
        "end": "2026-07-03T11:30:01.999999+00:00"
      },
      {
        "start": "2026-07-27T17:24:55.999999+00:00",
        "end": "2026-07-28T18:03:37.999999+00:00"
      },
      {
        "start": "2026-08-21T23:48:40.999999+00:00",
        "end": "2026-08-23T00:44:33.999999+00:00"
      },
      {
        "start": "2026-09-16T06:52:40.999999+00:00",
        "end": "2026-09-17T07:19:46.999999+00:00"
      },
      {
        "start": "2026-10-11T15:35:35.999999+00:00",
        "end": "2026-10-12T15:02:25.999999+00:00"
      },
      {
        "start": "2026-11-05T23:39:40.999999+00:00",
        "end": "2026-11-06T22:40:11.999999+00:00"
      },
      {
        "start": "2026-12-01T06:45:12.999999+00:00",
        "end": "2026-12-02T05:01:50.999999+00:00"
      },
      {
        "start": "2026-12-26T18:52:33.999999+00:00",
        "end": "2026-12-27T15:23:47.999999+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.