POST/api/astro/yoga_scan/1 Credit

Nitya-Yoga-Jahres-Scan

Das Nitya Yoga entsteht, wenn man die siderischen Längen von Sonne und Mond addiert und den Kreis in siebenundzwanzig Teile teilt. Jedes der siebenundzwanzig Yogas – Vishkambha bis Vaidhriti – dauert knapp einen Tag, und sie sind für die Elektionsastrologie wichtig: Vyatipata, Vaidhriti, Parigha, Vyaghata, Shoola, Ganda und Atiganda werden traditionell gemieden, Siddhi, Siddha, Shubha, Yogas der Amrita-Klasse und Sukarma dagegen gesucht. Dieser Endpoint nimmt ein Yoga beim Namen entgegen und liefert alle seine Vorkommen in einem Kalenderjahr. Bei `yoga_name` wird die Groß-/Kleinschreibung beachtet, und der Wert muss exakt mit dem Enum übereinstimmen. `year` und `timezone_as_float` legen das lokale Jahr fest; Koordinaten sind nicht nötig, weil das Yoga überall zum selben Zeitpunkt wechselt. Da die Summe der beiden Längen etwa alle 22.6 Stunden um rund 13 Grad 20 Minuten fortschreitet, kehrt jedes Yoga etwa vierzehn- oder fünfzehnmal im Jahr wieder. Die Antwort ist `{year, yoga_name, rows}`, wobei `rows` eine chronologische Liste von `{start, end}`-Zeitstempeln (UTC, ISO) ist. Jedes Paar gibt den echten Beginn und das echte Ende dieses Yogas an, gefunden durch Bisektion der Längensumme von Sonne und Mond statt durch Stichproben bei Sonnenaufgang; die Grenzen sind daher auf Bruchteile einer Sekunde genau.

https://api.occultapi.com/api/astro/yoga_scan/

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

Feld Typ Pflicht Hinweise

timezone_as_float

number (double)

Feld	Typ	Pflicht	Hinweise
timezone_as_float	number (double)	Pflicht	UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset.
year	integer	Pflicht	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 1800 · max 2400
yoga_name	string	Pflicht	`VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva`

Pflicht

UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset.

year

integer

Pflicht

Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern.

min 1800 · max 2400

yoga_name

string

Pflicht

VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva

Beispielanfrage

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"}'

Antwort

{
  "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
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.