POST/api/panchpakshi/1 crédit

Pancha Pakshi (journée en dix yamas)

Le Pancha Pakshi est un système de datation du sud de l’Inde qui attribue à chaque personne l’un de cinq oiseaux — vautour, hibou, corbeau, coq ou paon — et divise la journée en dix périodes appelées yamas : cinq entre le lever et le coucher du soleil, et cinq entre le coucher et le lever suivant. Dans la tradition complète, chaque oiseau traverse cinq états d’activité (régner, manger, marcher, dormir et mourir) au fil de ces périodes, et l’on place ses activités dans les périodes où son propre oiseau est fort. Cet endpoint renvoie les deux éléments sur lesquels repose ce système : les limites des yamas pour un jour et un lieu donnés, et l’oiseau de naissance pour un moment donné. `datetime`, `latitude`, `longitude` et `timezone_as_float` fixent le jour et le lieu. `fixed` choisit le découpage de la journée : avec false, ce sont le lever et le coucher du soleil locaux réels, si bien que les yamas de jour et de nuit n’ont pas la même durée et se décalent au fil de l’année ; avec true, la journée va de 06:00 à 18:00, ce qui donne dix périodes égales de 2 h 24 min, comme le supposent les tables traditionnelles. La réponse est `{yamas, birth panchpakshi}`. `yamas` contient `daytime` et `nighttime`, chacun étant une liste de cinq horodatages locaux `{start, end}` au format 'YYYY-MM-DD HH:MM:SS'. `birth panchpakshi` est une seule chaîne, parmi Vulture, Owl, Crow, Cock ou Peacock, tirée du groupe de nakshatras de la Lune à cet instant, combiné au paksha : le même groupe de nakshatras donne un oiseau différent en quinzaine croissante et en quinzaine décroissante, sauf le groupe du milieu, qui donne Crow dans les deux cas.

https://api.occultapi.com/api/panchpakshi/

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
datetime	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. Même signification que date_time, que d’autres endpoints désignent sous un autre nom.
fixed	boolean	obligatoire
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	`special` PARAMÈTRE SANS EFFET au niveau HTTP - PanchpakshiView n’appelle que get_birth_panchpakshi(date_time=... . Dans le moteur, la seule valeur significative est le littéral 'special', qui sélectionne la table nakshatras_special de 28 entrées au lieu de celle de 27 entrées par défaut.

Exemple de requête

curl -X POST https://api.occultapi.com/api/panchpakshi/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fixed":true,"datetime":"2024-11-21T09:39:20.910Z","latitude":26.1046,"longitude":74.319,"timezone_as_float":5.5}'

Réponse

{
  "data": {
    "yamas": {
      "daytime": [
        {
          "start": "2024-11-21 06:00:00",
          "end": "2024-11-21 08:24:00"
        },
        {
          "start": "2024-11-21 08:24:00",
          "end": "2024-11-21 10:48:00"
        },
        {
          "start": "2024-11-21 10:48:00",
          "end": "2024-11-21 13:12:00"
        },
        {
          "start": "2024-11-21 13:12:00",
          "end": "2024-11-21 15:36:00"
        },
        {
          "start": "2024-11-21 15:36:00",
          "end": "2024-11-21 18:00:00"
        }
      ],
      "nighttime": [
        {
          "start": "2024-11-21 18:00:00",
          "end": "2024-11-21 20:24:00"
        },
        {
          "start": "2024-11-21 20:24:00",
          "end": "2024-11-21 22:48:00"
        },
        {
          "start": "2024-11-21 22:48:00",
          "end": "2024-11-22 01:12:00"
        },
        {
          "start": "2024-11-22 01:12:00",
          "end": "2024-11-22 03:36:00"
        },
        {
          "start": "2024-11-22 03:36:00",
          "end": "2024-11-22 06:00:00"
        }
      ]
    },
    "birth panchpakshi": "Cock"
  },
  "message": "successful",
  "is_error": false
}

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

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.