Playground lädt
curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Ein Dosha ist eine bestimmte Belastung im Geburtshoroskop – eine benannte Planetenkonfiguration, die klassische Texte als nachteilig ansehen, meist für Ehe, Gesundheit oder die Ahnenlinie. Dieser Endpoint prüft acht davon anhand von Geburtszeitpunkt und -ort und liefert entweder die reinen Ergebnisse oder fertige Erklärungstexte zur Anzeige. Du kannst ihn auf zwei Arten nutzen. Die einzelnen Keys (`kala_sarpa`, `manglik`, `pitru_dosha` und die übrigen) liefern strukturierte Ergebnisse, die du im Code auswerten kannst. `get_dosha_details` liefert alles als formatierte HTML-Absätze mit dem englischen Dosha-Namen als Schlüssel – das Richtige, wenn du einen Bericht renderst. Enthalten sind Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata und Shrapit, nicht aber Ganda Moola. `get_dosha_resources` liefert dir den zugrunde liegenden Textkorpus, falls du eigene Texte zusammenstellen willst. Der Serializer verlangt alle booleschen und strukturierten Anfragefelder, auch für Keys, die sie ignorieren. `manglik_reference_planet` ist ein Planetenindex (0 Sonne, 1 Mond, 2 Mars, 3 Merkur, 4 Jupiter, 5 Venus, 6 Saturn, 7 Rahu, 8 Ketu); der eigentliche Standard des Rechenkerns – die Messung ab dem Aszendenten – lässt sich über die API nicht wählen, weil das Feld als Ganzzahl typisiert ist. Bei diesem Endpoint heißt das Feld für den UTC-Offset `timezone`, nicht `timezone_as_float`.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| apply_exceptions | boolean | Pflicht | |
| 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). |
| include_2nd_house | boolean | Pflicht | |
| include_lagna_house | boolean | Pflicht | |
| 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. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsArray von Strings. 'manglik' erfordert manglik_reference_planet, include_lagna_house, include_2nd_house und apply_exceptions; 'ganda_moola' erfordert moon_star; 'get_dosha_details' erfordert date_time und geopos. |
| 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 |
| manglik_reference_planet | integer | Pflicht | |
| moon_star | string | Pflicht | Inhaltlich eine Nakshatra-NUMMER 1-27 (die Ganda-Moola-Nakshatras sind 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Eine funktionierende Liste zulässiger Werte lässt sich erst angeben, wenn dieser Typkonflikt behoben ist. |
| timezone | number (double) | Pflicht | UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30). Bedeutet dasselbe wie timezone_as_float; andere Endpoints verwenden für dasselbe Feld nur einen anderen Namen. |
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 | |
|---|---|---|---|
| ganda_moola | moon_star | Ganda Moola: ob das Geburts-Nakshatra eines der sechs Übergangs-Nakshatras ist (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). Eigentlich soll der Key die Nakshatra-Nummer 1–27 in `moon_star` entgegennehmen und einen booleschen Wert liefern. Das Feld ist aber als String typisiert, während die Vergleichsliste Ganzzahlen enthält – derzeit liefert der Key deshalb für jede Eingabe false. | |
| get_dosha_details | date_time, geopos | Alle sieben beschreibenden Doshas auf einmal ausgewertet und als Text ausformuliert: ein Objekt mit dem englischen Dosha-Namen als Schlüssel – Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha und Shrapit Dosha. Die Werte sind HTML-Fragmente, die angeben, ob das Dosha vorliegt und was es bedeutet. Ganda Moola ist nicht enthalten. Erfordert `date_time` und den Ort. | |
| get_dosha_resources | — | Alle Erklärungstexte zu den Doshas, als Objekt mit dem Dosha-Namen als Schlüssel ('kala_sarpa', 'manglik', 'pitru', 'ghata' usw.) und jeweils einer Liste englischer Absätze. Der erste Eintrag einer Liste ist der Text für „Dosha liegt nicht vor“, die weiteren Einträge gehören zum jeweiligen Haus bzw. zur jeweiligen Variante. Damit kannst du eigene Texte rendern, statt das fertig zusammengesetzte HTML zu verwenden. | |
| ghata | — | Ghata Dosha: Mars und Saturn zusammen im selben Zeichen. Liefert einen einzelnen booleschen Wert. | |
| guru_chandala_dosha | — | Guru Chandala: Jupiter in Konjunktion mit Rahu oder Ketu im selben Zeichen. Liefert eine Liste mit zwei Elementen: [ob die Kombination vorliegt, ob Jupiter der stärkere der beiden ist]. Ohne Konjunktion sind beide false. | |
| kala_sarpa | — | Kala Sarpa Dosha: true, wenn alle sieben klassischen Planeten auf einer Seite der Knotenachse zwischen Rahu und Ketu eingeschlossen sind. Liefert einen einzelnen booleschen Wert; die Variante (Ananta, Kulika, Vasuki usw.) ergibt sich aus dem Haus, in dem Rahu steht. | |
| kalathra | — | Kalathra Dosha, die Belastung des Ehehauses. Ergibt true, wenn jeder natürliche Übeltäter – Sonne, Mars, Saturn, Rahu und Ketu – im 1., 2., 4., 7., 8. oder 12. Haus steht, gezählt ab dem 7. Haus. Liefert einen einzelnen booleschen Wert; weil alle fünf Übeltäter die Bedingung erfüllen müssen, ist er selten true. | |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik oder Mangal Dosha: ob Mars in einem der Häuser steht, die die Ehe belasten, gezählt ab `manglik_reference_planet`. Liefert eine Liste mit drei Elementen: [ist Manglik, ob eine Aufhebung greift, die Nummern der zutreffenden Aufhebungsregeln]. Geprüft werden das 4., 7., 8. und 12. Haus, außerdem das 2. Haus, wenn `include_2nd_house` true ist, und das 1. Haus, wenn `include_lagna_house` true ist. Aufhebungen werden nur ausgewertet, wenn `apply_exceptions` true ist. | |
| pitru_dosha | — | Pitru Dosha, die Belastung der Ahnenlinie. Liefert eine Liste mit zwei Elementen: [true oder false, die Nummern der ausgelösten Regeln]. Fünf Regeln werden der Reihe nach geprüft: ein Licht oder Rahu im 9. Haus, Ketu im 4. Haus, Sonne/Mond/Rahu/Ketu durch Mars oder Saturn verletzt, eine Häufung von Merkur, Venus und Rahu im 2., 5., 9. oder 12. Haus sowie Sonne oder Mond in Konjunktion mit einem Mondknoten. | |
| shrapit | — | Shrapit Dosha: Saturn und Rahu zusammen im selben Zeichen. Liefert einen einzelnen booleschen Wert. |