/api/astro/samvatsara/1 créditMaîtres de l’année hindoue
Le roi, le ministre et huit autres maîtres de l’année hindoue. Au début du samvatsara, on dresse le thème, et certaines planètes reçoivent des fonctions précises pour les douze mois suivants : le roi régit l’année dans son ensemble, le ministre le gouvernement, et d’autres maîtres la pluie, la richesse, les grains, les sucs, l’eau, les fruits, les récoltes et la défense. C’est le cadre dans lequel les éditeurs d’almanachs rédigent leurs prévisions annuelles. Chaque fonction est renvoyée avec ce qu’elle régit : `neersesha_of_year` se lit ainsi 'Lord of Water, governs rivers and water supply'. Le tout est accompagné du moment où l’année commence et du vaahana du samvatsara. Aucun thème natal n’est nécessaire. Le lieu compte en revanche : chaque fonction revient au maître du jour local, compté d’un lever du soleil au suivant, où tombe l’événement correspondant ; deux villes peuvent donc avoir des maîtres différents pour la même année. `year` est l’année grégorienne où commence le samvat.
https://api.occultapi.com/api/astro/samvatsara/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 |
| 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 |
| year | integer | obligatoire | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. |
| keys | array | facultatif | 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. |
| nakshatra | string | facultatif | Lu uniquement par /nakshatra-chakras/ ; ignoré ailleurs. |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/samvatsara/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025,"date_time":"2025-02-13T05:00:37Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Réponse
{
"data": {
"year": 2025,
"year_begins": "2025-03-30T06:23:38+05:30",
"vaahana": "Horse",
"cabinet": [
{
"office": "King (Raja)",
"key": "king_of_year",
"governs": "the year as a whole",
"planet": "Sun"
},
{
"office": "Minister (Mantri)",
"key": "mantri_of_year",
"governs": "governance and counsel",
"planet": "Sun"
},
{
"office": "Lord of Clouds (Meghesha)",
"key": "meghesha_of_year",
"governs": "rainfall",
"planet": "Sun"
},
{
"office": "Lord of Wealth (Dhanesha)",
"key": "dhanesha_of_year",
"governs": "money and trade",
"planet": "Mars"
},
{
"office": "Lord of Grain (Dhaanyesha)",
"key": "dhaanyesha_of_year",
"governs": "the grain harvest",
"planet": "Moon"
},
{
"office": "Lord of Juices (Rasesha)",
"key": "rasesha_of_year",
"governs": "sap, juices and liquids",
"planet": "Venus"
},
{
"office": "Lord of Water (Neeresha)",
"key": "neersesha_of_year",
"governs": "rivers and water supply",
"planet": "Mercury"
},
{
"office": "Lord of Fruit (Phalesha)",
"key": "phalesha_of_year",
"governs": "fruit crops",
"planet": "Saturn"
},
{
"office": "Lord of Crops (Sashyesha)",
"key": "sashyesha_of_year",
"governs": "standing crops",
"planet": "Mercury"
},
{
"office": "Lord of Forts (Durgesha)",
"key": "durgesha_of_year",
"governs": "defence and strongholds",
"planet": "Saturn"
}
],
"das_adhikari": {
"King": "Sun",
"Minister": "Sun",
"Lord of Clouds": "Sun",
"Lord of Summer Crops": "Mercury",
"Lord of Defence": "Saturn",
"Lord of Treasury": "Mars",
"Lord of Juicy Products": "Venus",
"Lord of Food Grains": "Moon",
"Lord of Metals": "Mercury",
"Lord of Fruits": "Saturn",
"Vehicle of Year": "Horse"
}
},
"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.
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.