/api/astro/sarvatobhadra/1 créditSarvatobhadra chakra
Le plateau de neuf cases sur neuf qui sert à juger les transits, avec les grahas placés et le vedha (perçage) calculé. Les vingt-huit nakshatras — les vingt-sept habituels plus Abhijit — occupent l’anneau extérieur dans un ordre fixe qui commence à Krittika et tourne dans le sens horaire, et NON dans l’ordre habituel des nakshatras. Les cases intérieures portent les douze signes, les sept jours de la semaine et un ensemble de syllabes. Un graha placé dans un nakshatra perce la case qui lui fait face de l’autre côté du plateau. La grille 9×9 complète est renvoyée avec les placements : vous pouvez donc dessiner le chakra, au lieu de vous contenter d’en lire un verdict. Chaque case indique ce qu’elle contient et si elle se trouve sur l’anneau. Passez `transit_date_time` pour placer les grahas en transit sur le même plateau — c’est à cela que sert réellement le chakra. `hits_natal` liste alors les grahas en transit dont le vedha tombe sur un nakshatra occupé dans votre thème natal. `rule` indique la règle de vedha appliquée. Seul le vedha positionnel est utilisé : la rangée du haut perce celle du bas dans la même colonne, la colonne de gauche perce celle de droite dans la même rangée. Les écoles qui ajoutent le vedha diagonal, de tithi ou de vaara obtiendront d’autres résultats ; plutôt que d’en retenir une sans le dire, chaque réponse nomme la règle appliquée. Une orthographe de nakshatra qui ne correspond à aucune case est renvoyée sous `unplaced` au lieu d’être omise : un graha ne disparaît donc jamais du plateau sans que vous le sachiez.
https://api.occultapi.com/api/astro/sarvatobhadra/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/jsonChamps de la requête
| 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. |
| 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 |
| ayanamsa | string | facultatif | |
| timezone_as_float | number (double) | facultatif | 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 |
| transit_date_time | string (date-time) | facultatif | Facultatif. S’il est fourni, les grahas en transit à ce moment sont placés sur le chakra à côté des grahas natals : c’est ainsi que le chakra se lit réellement. |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/sarvatobhadra/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Réponse
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"system\": \"sarvatobhadra\", \"size\": 9, \"palette\": {\"W\": \"#ffffff\", \"C\": \"#FFEFD8\", \"L\": \"#CEE1F6\", \"D\": \"#A7CDFA\", \"border\": \"#C0CCDF\", \"frame\": \"#5D636C\", \"layer1\": \"#E8F1FB\", \"layer2\": \"#F9FAFB\", \"text\": \"#374151\"}, \"grid\": [[{\"row\": 0, \"column\": 0, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"अ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 0, \"column\": 1, \"nakshatra\": \"Krittika\", \"nakshatra_key\": \"krittika\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"अ\", \"इ\", \"उ\", \"ए\"], \"short_name\": \"Kritika\", \"side\": \"top\"}, {\"row\": 0, \"column\": 2, \"nakshatra\": \"Rohini\", \"nakshatra_key\": \"rohini\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"ओ\", \"व\", \"वी\", \"वू\"], \"short_name\": \"Rohini\", \"side\": \"top\"}, {\"row\": 0, \"column\": 3, \"nakshatra\": \"Mrigashira\", \"nakshatra_key\": \"mrigashira\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"वे\", \"वो\", \"क\", \"की\"], \"short_name\": \"Mrigashi\", \"side\": \"top\"}, {\"row\": 0, \"column\": 4, \"nakshatra\": \"Ardra\", \"nakshatra_key\": \"ardra\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"कु\", \"घ\", \"ङ\", \"छ\"], \"short_name\": \"Ardra\", \"side\": \"top\"}, {\"row\": 0, \"column\": 5, \"nakshatra\": \"Punarvasu\", \"nakshatra_key\": \"punarvasu\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"के\", \"को\", \"ह\", \"ही\"], \"short_name\": \"Punarvasu\", \"side\": \"top\"}, {\"row\": 0, \"column\": 6, \"nakshatra\": \"Pushya\", \"nakshatra_key\": \"pushya\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"हु\", \"हे\", \"हो\", \"ड\"], \"short_name\": \"Pushya\", \"side\": \"top\"}, {\"row\": 0, \"column\": 7, \"nakshatra\": \"Ashlesha\", \"nakshatra_key\": \"ashlesha\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"डी\", \"डू\", \"डे\", \"डो\"], \"short_name\": \"Ashlesha\", \"side\": \"top\"}, {\"row\": 0, \"column\": 8, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"आ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}], [{\"row\": 1, \"column\": 0, \"nakshatra\": \"Bharani\", \"nakshatra_key\": \"bharani\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"ली\", \"लू\", \"ले\", \"लो\"], \"short_name\": \"Bharani\", \"side\": \"left\"}, {\"row\": 1, \"column\": 1, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"उ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 2, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"अ\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 3, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"व\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 4, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"क\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 5, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"द\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 6, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"ह\", \"ring\": false, \"shade\": \"D\", \"colour\": \"#A7CDFA\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 7, \"nakshatra\": null, \"nakshatra_key\": null, \"label\": \"ऊ\", \"ring\": false, \"shade\": \"W\", \"colour\": \"#ffffff\", \"padas\": null, \"short_name\": null, \"side\": null}, {\"row\": 1, \"column\": 8, \"nakshatra\": \"Magha\", \"nakshatra_key\": \"magha\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"म\", \"मी\", \"मू\", \"मे\"], \"short_name\": \"Magha\", \"side\": \"right\"}], [{\"row\": 2, \"column\": 0, \"nakshatra\": \"Ashwini\", \"nakshatra_key\": \"ashwini\", \"label\": null, \"ring\": true, \"shade\": \"C\", \"colour\": \"#FFEFD8\", \"padas\": [\"चू\", \"चे\", \"चो\", \"ला\"], \"short_name\": \"Ashwini\", \"side"
}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.