Chargement du Playground
curl -X POST https://api.occultapi.com/api/astro/pancha_pakshi_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","keys":["get_birth_bird_from_nakshathra","get_birth_nakshathra","get_matching_pancha_pakshi_data_from_db"],"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"nakshatras":"special"}'Le Pancha Pakshi Shastra est un système tamoul qui attribue à chaque personne l’un de cinq oiseaux — vautour, hibou, corbeau, coq ou paon — d’après son nakshatra de naissance et sa quinzaine, puis rythme la journée selon l’activité de cet oiseau. Chaque oiseau passe par cinq activités, de la plus favorable à la moins favorable : régner, manger, marcher, dormir et mourir ; chaque partie de la journée est bonne ou mauvaise selon le rapport entre l’activité de votre oiseau et celle qui est en vigueur. Utilisez get_birth_bird_from_nakshathra pour l’oiseau lui-même ; get_birth_nakshathra et get_paksha renvoient les deux données dont il découle, utiles pour montrer le détail du calcul. Les trois renvoient de simples entiers, pas des noms. get_matching_pancha_pakshi_data_from_db renvoie la table d’activités brute de cet oiseau pour le jour de la semaine et la quinzaine du moment demandé : cinquante lignes numériques couvrant cinq périodes principales du jour et cinq de la nuit, chacune divisée en cinq sous-périodes. Les colonnes sont des indices et des fractions, pas des heures — c’est à vous de calculer les heures à partir du lever et du coucher du soleil et des facteurs de durée. Le champ de requête nakshatras est accepté par le sérialiseur mais n’est pas utilisé par cet endpoint.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| date_time | string (date-time) | obligatoire | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. |
| 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. |
| latitude | number (double) | obligatoire | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -90 · max 90 |
| longitude | number (double) | obligatoire | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180 |
| timezone_as_float | number (double) | obligatoire | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14 |
| nakshatras | string | facultatif | specialPARAMÈTRE SANS EFFET au niveau HTTP - PanchaPakshaHoraView ne transmet que date_time, geopos et le chemin du CSV pancha_pakshi_db. Dans le moteur, la seule valeur significative est le littéral 'special' (substitue la table nakshatras_special de 28 entrées. |
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_birth_bird_from_nakshathra | — | L’oiseau de naissance sous forme d’un seul entier de 1 à 5 — 1 vautour, 2 hibou, 3 corbeau, 4 coq, 5 paon — dérivé du nakshatra de naissance combiné à la quinzaine, si bien que le même nakshatra donne des oiseaux différents dans les deux moitiés du mois. | |
| get_birth_nakshathra | — | Le nakshatra de naissance sous forme d’un seul entier de 1 à 27, en comptant à partir d’Ashwini — la donnée dont ont besoin les autres recherches de cet endpoint. Aucun nom n’est renvoyé, seulement le numéro. | |
| get_matching_pancha_pakshi_data_from_db | — | La table d’activités brute de l’oiseau de naissance pour le jour de la semaine et la quinzaine du moment demandé : cinquante lignes, chacune une liste de quatorze nombres, dans l’ordre des colonnes indice du jour de la semaine, indice du paksha, indice jour/nuit, oiseau principal, activité principale, sous-oiseau, sous-activité, facteur de durée, relation, facteur de puissance, effet, note, padu pakshi, bharana pakshi. Les oiseaux vont de 0 à 4 : vautour, hibou, corbeau, coq, paon ; les activités vont de 0 à 4 : régner, manger, marcher, dormir, mourir ; relation vaut 0 ennemi, 1 identique, 2 ami ; effet va de 0 à 4, de très mauvais à très bon. Les lignes vont par groupes de cinq — cinq périodes principales par moitié de journée, chacune subdivisée en cinq — et le facteur de durée donne la part de chaque sous-période dans sa période parente. Aucune heure n’est incluse ; construisez-les à partir du lever et du coucher du soleil et des facteurs. | |
| get_paksha | — | La quinzaine lunaire où tombe le moment demandé, sous forme d’un seul entier : 1 pour Shukla (croissante), 2 pour Krishna (décroissante). Le Pancha Pakshi attribue un oiseau différent au même nakshatra selon la quinzaine : cette valeur modifie donc le résultat. |