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"}'Les éléments du panchanga — jour de la semaine, tithi, karana, yoga et quinzaine, plus la hora planétaire — sont chacun associés à une lecture classique du caractère de la personne née sous leur influence. Cet endpoint est la table de consultation de ces lectures. Il s’agit uniquement de textes de référence : rien n’est calculé, et aucune date, heure ni aucun lieu n’est envoyé. Vous déterminez ailleurs la tithi de naissance, le jour de la semaine, etc. de la personne (par exemple avec /api/astro/panchanga/), puis vous passez les noms pour obtenir le paragraphe correspondant à chacun. Les six clés de consultation sont get_vaara_during_birth, get_birth_tithi_effects, get_birth_karana_effects, get_birth_panchang_yoga_effects, get_birth_paksha_effects et get_birth_hora_result ; chacune prend le champ de requête du même nom. Toutes les valeurs acceptées sont des translittérations en minuscules dont l’orthographe exacte compte — 'shula' et non 'shoola', 'priti' et non 'preeti' — et la hora se désigne par le nom sanskrit de la planète (surya, chandra, mangala…), non par le jour de la semaine. Les six fonctions d’aide get_all_*_keys renvoient les listes acceptées, et get_all_keys_summary les renvoie toutes les six d’un coup ; utilisez-les plutôt que de coder le vocabulaire en dur. Une valeur non reconnue ne provoque pas d’erreur : elle renvoie HTTP 200 avec une chaîne qui liste les options valides.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| keys | array | obligatoire | Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. |
| hora | string | facultatif | suryachandramangalabudhabrihaspatishukrashaniUne valeur inconnue renvoie la chaîne "Invalid hora: <x>. Available options: [...]" avec HTTP 200 plutôt qu’un statut d’erreur ; l’endpoint expose aussi une clé associée 'get_all_hora_keys' qui renvoie exactement cette liste à l’exécution. Attention au style de translittération : 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (et non shoola/preeti/indra), et les valeurs de hora sont les noms sanskrits des planètes (surya/chandra/mangala/budha/brihaspati/shukra/shani), et non des noms de jours de la semaine ou de planètes en anglais. |
| karana | string | facultatif | bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughnaUne valeur inconnue renvoie la chaîne "Invalid karana: <x>. Available options: [...]" avec HTTP 200 plutôt qu’un statut d’erreur ; l’endpoint expose aussi une clé associée 'get_all_karana_keys' qui renvoie exactement cette liste à l’exécution. Attention au style de translittération : 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (et non shoola/preeti/indra), et les valeurs de hora sont les noms sanskrits des planètes (surya/chandra/mangala/budha/brihaspati/shukra/shani), et non des noms de jours de la semaine ou de planètes en anglais. |
| paksha | string | facultatif | shuklakrishnaUne valeur inconnue renvoie la chaîne "Invalid paksha: <x>. Available options: [...]" avec HTTP 200 plutôt qu’un statut d’erreur ; l’endpoint expose aussi une clé associée 'get_all_paksha_keys' qui renvoie exactement cette liste à l’exécution. Attention au style de translittération : 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (et non shoola/preeti/indra), et les valeurs de hora sont les noms sanskrits des planètes (surya/chandra/mangala/budha/brihaspati/shukra/shani), et non des noms de jours de la semaine ou de planètes en anglais. |
| tithi | string | facultatif | pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashiUne valeur inconnue renvoie la chaîne "Invalid tithi: <x>. Available options: [...]" avec HTTP 200 plutôt qu’un statut d’erreur ; l’endpoint expose aussi une clé associée 'get_all_tithi_keys' qui renvoie exactement cette liste à l’exécution. Attention au style de translittération : 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (et non shoola/preeti/indra), et les valeurs de hora sont les noms sanskrits des planètes (surya/chandra/mangala/budha/brihaspati/shukra/shani), et non des noms de jours de la semaine ou de planètes en anglais. |
| vaara | string | facultatif | sundaymondaytuesdaywednesdaythursdayfridaysaturdayUne valeur inconnue renvoie la chaîne "Invalid vaara: <x>. Available options: [...]" avec HTTP 200 plutôt qu’un statut d’erreur ; l’endpoint expose aussi une clé associée 'get_all_vaara_keys' qui renvoie exactement cette liste à l’exécution. Attention au style de translittération : 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (et non shoola/preeti/indra), et les valeurs de hora sont les noms sanskrits des planètes (surya/chandra/mangala/budha/brihaspati/shukra/shani), et non des noms de jours de la semaine ou de planètes en anglais. |
| yoga | string | facultatif | vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruvaUne valeur inconnue renvoie la chaîne "Invalid yoga: <x>. Available options: [...]" avec HTTP 200 plutôt qu’un statut d’erreur ; l’endpoint expose aussi une clé associée 'get_all_yoga_keys' qui renvoie exactement cette liste à l’exécution. Attention au style de translittération : 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (et non shoola/preeti/indra), et les valeurs de hora sont les noms sanskrits des planètes (surya/chandra/mangala/budha/brihaspati/shukra/shani), et non des noms de jours de la semaine ou de planètes en anglais. |
Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.
| Clé | Champs supplémentaires requis | Description | |
|---|---|---|---|
| get_all_hora_keys | — | Les sept noms de hora acceptés par cet endpoint, sous forme de liste de noms sanskrits de planètes en minuscules. | |
| get_all_karana_keys | — | Les onze noms de karana acceptés par cet endpoint, sous forme de liste de chaînes en minuscules. | |
| get_all_keys_summary | — | Toutes les valeurs acceptées pour les six catégories dans un seul objet, avec les clés vaara_keys, hora_keys, paksha_keys, tithi_keys, karana_keys et yoga_keys. Un seul appel au lieu de six. | |
| get_all_paksha_keys | — | Les deux noms de quinzaine acceptés par cet endpoint, sous forme de liste de chaînes en minuscules : shukla et krishna. | |
| get_all_tithi_keys | — | Les seize noms de tithi acceptés par cet endpoint, sous forme de liste de chaînes en minuscules. Utilisez-la pour alimenter un sélecteur plutôt que de coder les orthographes en dur. | |
| get_all_vaara_keys | — | Les sept noms de jours de la semaine acceptés par cet endpoint, sous forme de liste de noms de jours en anglais, en minuscules. | |
| get_all_yoga_keys | — | Les vingt-sept noms de Nityayoga acceptés par cet endpoint, sous forme de liste de chaînes en minuscules. | |
| get_birth_hora_result | hora | La lecture associée à la hora planétaire qui régit le moment de la naissance. Prend hora sous forme de nom sanskrit de planète en minuscules — surya, chandra, mangala, budha, brihaspati, shukra, shani — et renvoie un court paragraphe rédigé en anglais. | |
| get_birth_karana_effects | karana | La lecture associée au karana de naissance. Prend karana sous la forme de l’un des onze noms en minuscules (bava, balava, kaulava, taitila, gara, vanija, vishti, shakuni, chatushpada, naga, kimstughna) et renvoie un paragraphe rédigé en anglais. | |
| get_birth_paksha_effects | paksha | La lecture associée à une naissance pendant la quinzaine claire ou sombre. Prend paksha sous la forme 'shukla' ou 'krishna' et renvoie un paragraphe rédigé en anglais. | |
| get_birth_panchang_yoga_effects | yoga | La lecture associée au Nityayoga en vigueur à la naissance. Prend yoga sous la forme de l’un des vingt-sept noms en minuscules, de vishkumbha à vaidhriti, et renvoie un paragraphe rédigé en anglais. | |
| get_birth_tithi_effects | tithi | La lecture associée à la tithi de naissance. Prend tithi sous la forme de l’un des seize noms en minuscules — de pratipada à chaturdashi, plus purnima et amavasya — et renvoie un paragraphe rédigé en anglais. Un même nom couvre cette tithi dans les deux quinzaines. | |
| get_vaara_during_birth | vaara | La lecture de caractère associée à une naissance un jour de la semaine donné. Prend vaara sous forme de nom de jour en anglais, en minuscules, et renvoie un paragraphe rédigé en anglais. Une valeur non reconnue renvoie une chaîne qui liste les options valides, toujours avec HTTP 200. |