curl -X POST https://api.occultapi.com/api/astro/panchang_element_birth_effect/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_vaara_during_birth"],"vaara":"sunday","hora":"surya","paksha":"shukla","tithi":"pratipada","karana":"bava","yoga":"vishkumbha"}'Zu jedem Glied des Panchanga – Wochentag, Tithi, Karana, Yoga und Monatshälfte, dazu die planetare Hora – gibt es eine klassische Charakterdeutung für Menschen, die darunter geboren sind. Dieser Endpoint ist die Nachschlagetabelle für diese Deutungen. Er liefert reinen Referenztext: Es wird nichts berechnet, und weder Datum noch Uhrzeit noch Ort werden gesendet. Geburts-Tithi, Wochentag usw. ermittelst du vorher anderweitig (etwa über /api/astro/panchanga/) und übergibst dann die Namen, um jeweils den passenden Absatz zu erhalten. Die sechs Nachschlage-Keys sind get_vaara_during_birth, get_birth_tithi_effects, get_birth_karana_effects, get_birth_panchang_yoga_effects, get_birth_paksha_effects und get_birth_hora_result; jeder liest ein gleichnamiges Anfragefeld. Alle zulässigen Werte sind kleingeschriebene Transliterationen, und die genaue Schreibweise ist entscheidend – 'shula', nicht 'shoola'; 'priti', nicht 'preeti'. Die Hora wird nach dem Sanskrit-Namen des Planeten benannt (surya, chandra, mangala…), nicht nach dem Wochentag. Die sechs Hilfs-Keys get_all_*_keys liefern die zulässigen Listen, get_all_keys_summary alle sechs auf einmal; nutze sie, statt das Vokabular fest im Code zu hinterlegen. Ein unbekannter Wert führt nicht zu einem Fehler, sondern liefert HTTP 200 mit einem String, der die gültigen Optionen aufzählt.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| 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. |
| hora | string | optional | suryachandramangalabudhabrihaspatishukrashaniEin unbekannter Wert liefert den String "Invalid hora: <x>. Available options: [...]" mit HTTP 200 statt eines Fehlerstatus; der Endpoint bietet außerdem den Begleit-Key 'get_all_hora_keys', der genau diese Liste zur Laufzeit liefert. Achte auf den Transliterationsstil: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (nicht shoola/preeti/indra), und die Hora-Werte sind die Sanskrit-Planetennamen (surya/chandra/mangala/budha/brihaspati/shukra/shani), keine englischen Wochentags- oder Planetennamen. |
| karana | string | optional | bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughnaEin unbekannter Wert liefert den String "Invalid karana: <x>. Available options: [...]" mit HTTP 200 statt eines Fehlerstatus; der Endpoint bietet außerdem den Begleit-Key 'get_all_karana_keys', der genau diese Liste zur Laufzeit liefert. Achte auf den Transliterationsstil: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (nicht shoola/preeti/indra), und die Hora-Werte sind die Sanskrit-Planetennamen (surya/chandra/mangala/budha/brihaspati/shukra/shani), keine englischen Wochentags- oder Planetennamen. |
| paksha | string | optional | shuklakrishnaEin unbekannter Wert liefert den String "Invalid paksha: <x>. Available options: [...]" mit HTTP 200 statt eines Fehlerstatus; der Endpoint bietet außerdem den Begleit-Key 'get_all_paksha_keys', der genau diese Liste zur Laufzeit liefert. Achte auf den Transliterationsstil: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (nicht shoola/preeti/indra), und die Hora-Werte sind die Sanskrit-Planetennamen (surya/chandra/mangala/budha/brihaspati/shukra/shani), keine englischen Wochentags- oder Planetennamen. |
| tithi | string | optional | pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashiEin unbekannter Wert liefert den String "Invalid tithi: <x>. Available options: [...]" mit HTTP 200 statt eines Fehlerstatus; der Endpoint bietet außerdem den Begleit-Key 'get_all_tithi_keys', der genau diese Liste zur Laufzeit liefert. Achte auf den Transliterationsstil: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (nicht shoola/preeti/indra), und die Hora-Werte sind die Sanskrit-Planetennamen (surya/chandra/mangala/budha/brihaspati/shukra/shani), keine englischen Wochentags- oder Planetennamen. |
| vaara | string | optional | sundaymondaytuesdaywednesdaythursdayfridaysaturdayEin unbekannter Wert liefert den String "Invalid vaara: <x>. Available options: [...]" mit HTTP 200 statt eines Fehlerstatus; der Endpoint bietet außerdem den Begleit-Key 'get_all_vaara_keys', der genau diese Liste zur Laufzeit liefert. Achte auf den Transliterationsstil: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (nicht shoola/preeti/indra), und die Hora-Werte sind die Sanskrit-Planetennamen (surya/chandra/mangala/budha/brihaspati/shukra/shani), keine englischen Wochentags- oder Planetennamen. |
| yoga | string | optional | vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruvaEin unbekannter Wert liefert den String "Invalid yoga: <x>. Available options: [...]" mit HTTP 200 statt eines Fehlerstatus; der Endpoint bietet außerdem den Begleit-Key 'get_all_yoga_keys', der genau diese Liste zur Laufzeit liefert. Achte auf den Transliterationsstil: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (nicht shoola/preeti/indra), und die Hora-Werte sind die Sanskrit-Planetennamen (surya/chandra/mangala/budha/brihaspati/shukra/shani), keine englischen Wochentags- oder Planetennamen. |
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 | |
|---|---|---|---|
| get_all_hora_keys | — | Die sieben Hora-Namen, die dieser Endpoint akzeptiert, als Liste kleingeschriebener Sanskrit-Planetennamen. | |
| get_all_karana_keys | — | Die elf Karana-Namen, die dieser Endpoint akzeptiert, als Liste kleingeschriebener Strings. | |
| get_all_keys_summary | — | Alle zulässigen Werte der sechs Kategorien in einem Objekt, mit den Schlüsseln vaara_keys, hora_keys, paksha_keys, tithi_keys, karana_keys und yoga_keys. Ein Aufruf statt sechs. | |
| get_all_paksha_keys | — | Die beiden Namen der Monatshälften, die dieser Endpoint akzeptiert, als Liste kleingeschriebener Strings: shukla und krishna. | |
| get_all_tithi_keys | — | Die sechzehn Tithi-Namen, die dieser Endpoint akzeptiert, als Liste kleingeschriebener Strings. Befülle damit eine Auswahlliste, statt die Schreibweisen fest im Code zu hinterlegen. | |
| get_all_vaara_keys | — | Die sieben Wochentagsnamen, die dieser Endpoint akzeptiert, als Liste kleingeschriebener englischer Tagesnamen. | |
| get_all_yoga_keys | — | Die siebenundzwanzig Nityayoga-Namen, die dieser Endpoint akzeptiert, als Liste kleingeschriebener Strings. | |
| get_birth_hora_result | hora | Die Deutung für die planetare Hora, die den Geburtszeitpunkt beherrscht. Nimmt hora als kleingeschriebenen Sanskrit-Planetennamen entgegen – surya, chandra, mangala, budha, brihaspati, shukra, shani – und liefert einen kurzen Absatz englischen Fließtexts. | |
| get_birth_karana_effects | karana | Die Deutung für das Geburts-Karana. Nimmt karana als einen der elf kleingeschriebenen Namen entgegen (bava, balava, kaulava, taitila, gara, vanija, vishti, shakuni, chatushpada, naga, kimstughna) und liefert einen Absatz englischen Fließtexts. | |
| get_birth_paksha_effects | paksha | Die Deutung für die Geburt in der hellen oder dunklen Monatshälfte. Nimmt paksha als 'shukla' oder 'krishna' entgegen und liefert einen Absatz englischen Fließtexts. | |
| get_birth_panchang_yoga_effects | yoga | Die Deutung für das bei der Geburt gültige Nityayoga. Nimmt yoga als einen der siebenundzwanzig kleingeschriebenen Namen entgegen, vishkumbha bis vaidhriti, und liefert einen Absatz englischen Fließtexts. | |
| get_birth_tithi_effects | tithi | Die Deutung für die Geburts-Tithi. Nimmt tithi als einen von sechzehn kleingeschriebenen Namen entgegen – pratipada bis chaturdashi, dazu purnima und amavasya – und liefert einen Absatz englischen Fließtexts. Ein Name deckt diese Tithi in beiden Monatshälften ab. | |
| get_vaara_during_birth | vaara | Die Charakterdeutung für die Geburt an einem bestimmten Wochentag. Nimmt vaara als kleingeschriebenen englischen Tagesnamen entgegen und liefert einen Absatz englischen Fließtexts. Ein unbekannter Wert liefert einen String mit den gültigen Optionen, ebenfalls mit HTTP 200. |