/api/astro/dasha_applicability/1 CreditDasha-Anwendbarkeit
Die vedische Astrologie kennt viele Systeme planetarer Perioden, und die meisten Nakshatra-basierten Systeme neben Vimshottari sind bedingt: Laut den klassischen Texten gilt Ashtottari nur, wenn im Horoskop eine bestimmte Bedingung erfüllt ist, Dwadashottari nur bei einer anderen, und so weiter. Wer falsch wählt, legt einem ganzen Leben die falsche Zeitleiste zugrunde. Dieser Endpoint prüft diese Bedingungen für dich. Er erstellt aus den Geburtsdaten das Rashi-, das Navamsa- und das Dwadasamsa-Horoskop und prüft sechs bedingte Systeme – Ashtottari, Chaturaseeti Sama, Dwadashottari, Dwisaptati, Panchottari und Sataabdika –, jedes anhand des Horoskops, nach dem es klassisch beurteilt wird. Sende Geburtszeitpunkt und -ort zusammen mit `year_option` (die Jahreslänge in Tagen), `start_option` und `direction_option` – dieselben Periodeneinstellungen, die auch die Dasha-Endpoints erwarten. Anhand des Ergebnisses entscheidest du, welchen Dasha-Endpoint du als Nächstes aufrufst.
https://api.occultapi.com/api/astro/dasha_applicability/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/jsonFelder der Anfrage
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| date_time | string (date-time) | Pflicht | Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten. FORMATVORGABE. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen). |
| direction_option | string | Pflicht | forwardbackwardGroß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. Alles andere liefert 400 "Invalid direction: must be 'forward' or 'backward'". |
| keys | array | Pflicht | Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen. applicability_checkArray von Strings; es gibt nur einen Key. |
| latitude | number (double) | Pflicht | Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. min -90 · max 90 |
| longitude | number (double) | Pflicht | Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China. min -180 · max 180 |
| start_option | string | Pflicht | currentnextpreviousGroß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. Alles andere liefert 400 "Invalid start value: must be 'current', 'next', or 'previous'". Höchstlänge 100. |
| 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. min -12 · max 14 |
| year_option | number (double) | Pflicht | 365.256364365.24219365.25365360min 360 · max 365.256364 |
Verfügbare Keys (1)
Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.
| Key | Zusätzliche Felder | Beschreibung |
|---|---|---|
| applicability_check | — | Die bedingten Nakshatra-Dasha-Systeme, deren klassische Voraussetzungen dieses Horoskop erfüllt, als Liste von Anzeigenamen aus "Ashtottari Dasha", "Chaturaseeti Sama Dasha", "Dwadashottari Dasha", "Dwisaptati Dasha", "Panchottari Dasha" und "Sataabdika Dasha". Eine leere Liste bedeutet, dass keines der sechs Systeme gilt. Vimshottari ist an keine Bedingung geknüpft und daher nicht enthalten. |
Beispielanfrage
curl -X POST https://api.occultapi.com/api/astro/dasha_applicability/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["applicability_check"],"date_time":"2025-03-27T09:52:50.441Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year_option":365.256364,"start_option":"current","direction_option":"forward"}'Antwort
{
"data": {
"applicability_check": []
},
"status": 200,
"is_error": false,
"message": "successful"
}Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.
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.