POST/api/astro/tithi_scan/1 Credit

Tithi-Jahres-Scan

Eine Tithi ist ein Dreißigstel des Mondmonats – die Zeitspanne, in der der Mond weitere 12 Grad Elongation gegenüber der Sonne gewinnt. Fast alle hinduistischen Festtage sind über Tithis definiert, und Tithis decken sich nicht mit bürgerlichen Tagen: Eine kann nur etwa neunzehn, aber auch bis zu etwa sechsundzwanzig Stunden dauern, sodass sich ein einzelnes Vorkommen oft über zwei Kalenderdaten erstreckt. Dieser Endpoint nimmt eine bestimmte Tithi entgegen und liefert alle ihre Vorkommen in einem Kalenderjahr, jeweils mit dem wahren Zeitpunkt von Beginn und Ende. `tithi_number` läuft von 1 bis 30: 1-15 sind Shukla Pratipada bis Purnima, 16-29 sind Krishna Pratipada bis Chaturdashi, und 30 ist Amavasya. `year` ist das lokale Kalenderjahr, und `timezone_as_float` bestimmt, welches lokale Jahr das ist (5.5 für IST). Koordinaten sind nicht nötig, weil eine Tithi überall auf der Erde zum selben Zeitpunkt beginnt und endet. Die Antwort ist `{year, tithi_number, rows}`, wobei `rows` eine chronologische Liste von `{start, end}`-Zeitstempeln (UTC, ISO) ist – meist zwölf oder dreizehn Einträge, da eine Tithi einmal pro Mondmonat wiederkehrt. Die Zeitfenster werden nicht an dazwischenliegenden Sonnenaufgängen geteilt; ein Vorkommen, das über zwei bürgerliche Tage reicht, wird also als eine einzige Zeile geliefert.

https://api.occultapi.com/api/astro/tithi_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)	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.
tithi_number	integer	Pflicht	min 1 · max 30
year	integer	Pflicht	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 1800 · max 2400

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.

tithi_number

integer

Pflicht

min 1 · max 30

year

integer

Pflicht

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

min 1800 · max 2400

Beispielanfrage

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

Antwort

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

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.