POST/api/astro/panchang_element_birth_effect/1 crédit

Effets du panchanga de naissance (table de référence)

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.

https://api.occultapi.com/api/astro/panchang_element_birth_effect/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Champs de la requête

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	`suryachandramangalabudhabrihaspatishukrashani` Une 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	`bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughna` Une 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	`shuklakrishna` Une 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	`pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashi` Une 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	`sundaymondaytuesdaywednesdaythursdayfridaysaturday` Une 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	`vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruva` Une 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.

Clés disponibles (13)

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.

Exemple de requête

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

Réponse

{
  "data": {
    "get_vaara_during_birth": "Individuals born on Sunday typically possess a steady and determined nature with a fearless approach to life. They often have a naturally authoritative disposition and demonstrate skillfulness in their endeavors. These individuals tend to be honorable and maintain high standards of purity in their conduct. They may have a tendency toward bilious temperament and often exhibit leadership qualities with a noble bearing."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data, sous le nom de chaque clé demandée.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.