/api/astro/nakshatra_transitions/1 créditTransitions de nakshatras
Le passage de chaque planète d’un nakshatra au suivant sur une année civile, chaque franchissement étant calculé à la seconde près environ. C’est la table du « gochar des planètes par nakshatra » : quand Saturne quitte Purva Bhadrapada, quand Jupiter entre dans Pushya, quand la Lune change de nakshatra — les événements qui servent à dater les prévisions de transit. granularity fixe la résolution. 'nakshatra' utilise les divisions de 13°20' et renvoie from et to sous forme de simples noms ; 'pada' utilise les quarts de 3°20' et renvoie from et to sous forme d’objets {nakshatra, pada}. Mettez use_28_nakshatras à true pour inclure Abhijit comme vingt-huitième division. Passez year et timezone_as_float. Le décalage détermine le début et la fin de l’année locale, mais les horodatages renvoyés sont en UTC — convertissez-les vous-même pour l’affichage. La réponse est {year, granularity, planets}, où planets est indexé par nom (sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu, ketu), chaque entrée contenant une liste chronologique de {from, to, datetime}. La Lune produit à elle seule plus de trois cents transitions de nakshatra par an et environ mille quatre cents transitions de pada : les réponses en pada sont donc volumineuses.
https://api.occultapi.com/api/astro/nakshatra_transitions/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 |
|---|---|---|---|
| granularity | string | obligatoire | nakshatrapada |
| year | integer | obligatoire | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. min 1800 · max 2400 |
| 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é. |
| use_28_nakshatras | boolean | facultatif |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/nakshatra_transitions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"granularity":"nakshatra","year":2026,"timezone_as_float":5.5}'Réponse
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"granularity\": \"nakshatra\", \"planets\": {\"jupiter\": [{\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-06-18 15:31:55\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-18 21:42:28\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-10-31 06:32:43\"}], \"sun\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 03:06:16\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-24 05:20:24\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-06 08:35:04\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-02-19 13:03:28\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-04 19:24:10\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-03-18 03:51:12\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-03-31 14:40:06\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-04-14 04:02:39\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-04-27 19:47:57\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-05-11 14:01:16\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-05-25 10:07:52\"}, {\"from\": \"Rohini\", \"to\": \"Mrigasira\", \"datetime\": \"2026-06-08 08:03:01\"}, {\"from\": \"Mrigasira\", \"to\": \"Aardra\", \"datetime\": \"2026-06-22 06:56:07\"}, {\"from\": \"Aardra\", \"to\": \"Punarvasu\", \"datetime\": \"2026-07-06 06:33:36\"}, {\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-07-20 05:58:19\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-03 04:54:24\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-08-17 02:28:46\"}, {\"from\": \"Makha\", \"to\": \"Poorva Phalguni\", \"datetime\": \"2026-08-30 22:29:09\"}, {\"from\": \"Poorva Phalguni\", \"to\": \"Uttara Phalguni\", \"datetime\": \"2026-09-13 16:17:57\"}, {\"from\": \"Uttara Phalguni\", \"to\": \"Hasta\", \"datetime\": \"2026-09-27 07:49:50\"}, {\"from\": \"Hasta\", \"to\": \"Chitra\", \"datetime\": \"2026-10-10 20:50:07\"}, {\"from\": \"Chitra\", \"to\": \"Swaati\", \"datetime\": \"2026-10-24 07:20:48\"}, {\"from\": \"Swaati\", \"to\": \"Visaakha\", \"datetime\": \"2026-11-06 15:33:21\"}, {\"from\": \"Visaakha\", \"to\": \"Anooraadha\", \"datetime\": \"2026-11-19 21:33:50\"}, {\"from\": \"Anooraadha\", \"to\": \"Jyeshtha\", \"datetime\": \"2026-12-03 01:58:15\"}, {\"from\": \"Jyeshtha\", \"to\": \"Moola\", \"datetime\": \"2026-12-16 04:55:02\"}, {\"from\": \"Moola\", \"to\": \"Poorvaashaadha\", \"datetime\": \"2026-12-29 07:14:19\"}], \"rahu\": [{\"from\": \"Satabhishak\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-08-01 21:41:47\"}], \"pluto\": [{\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-02-18 02:18:30\"}, {\"from\": \"Sravanam\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-07-29 15:00:03\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-12-28 01:39:54\"}], \"saturn\": [{\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-01-20 05:22:43\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-05-17 09:07:48\"}, {\"from\": \"Revati\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-10-09 15:21:10\"}], \"uranus\": [{\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-07-11 23:54:01\"}, {\"from\": \"Rohini\", \"to\": \"Krittika\", \"datetime\": \"2026-11-12 10:52:56\"}], \"mars\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 15:40:42\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-28 19:08:49\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-14 19:08:16\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-03-03 17:24:52\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-20 15:51:47\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-04-06 16:26:20\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-04-23 20:52:02\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-05-11 07:08:41\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-05-29 00:55:31\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-06-16 04:02:43\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"20"
}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.