/api/astro/prashna/1 créditPoints sensibles du prashna
Le prashna est l’astrologie horaire : un thème dressé pour le moment où une question est posée plutôt que pour une naissance. Cet endpoint calcule les points sensibles sur lesquels reposent le prashna et l’étude de la longévité — des combinaisons arithmétiques de longitudes qui ne sont pas des planètes, mais se lisent comme si elles l’étaient. Gulika, aussi appelé Mandi, le point d’ombre associé à Saturne, entre dans la composition de la plupart d’entre eux. Envoyez `date_time` en ISO 8601, `latitude`, `longitude`, un libellé `name` pour le thème, `node_type` (nœud lunaire `true` ou `mean`) et `add_yogi_longitude`. Tout est renvoyé d’un coup ; il n’y a pas de clés à choisir. À l’exception de `gulika_longitude`, simple nombre de degrés, chaque point est renvoyé sous la forme `{longitude, astrological: {degree, sign, minutes, seconds}, constellation, nakshatra, pada}` — une longitude sidérale avec sa position dans un signe, un indice de nakshatra à partir de 0, ainsi que le nom et le quart du nakshatra. Ce que représente chacun : `trisphuta` est ascendant plus Lune plus Gulika ; `chatursphuta` y ajoute le Soleil ; `panchasphuta` y ajoute le nœud lunaire. `pranasphuta` (cinq fois l’ascendant, plus Gulika), `dehasphuta` (huit fois la Lune, plus Gulika) et `mrityusphuta` (sept fois Gulika, plus le Soleil) sont les points de la vie, du corps et de la mort, et `sookshmatrisphuta` est leur somme. `beejasphuta` (Soleil plus Jupiter plus Vénus) et `kshetrasphuta` (Lune plus Jupiter plus Mars) sont les points de fertilité masculin et féminin. `tithisphuta` est Lune moins Soleil, et `rahutithisphuta` la même chose avec le nœud à la place de la Lune. `yogisphuta` est Soleil plus Lune plus 93°20', `avayogisphuta` ce résultat plus 186°40' supplémentaires, et `santanatithi` vaut cinq douzièmes de l’arc Lune moins Soleil. Trois points de vigilance. `yogasphuta` est le même calcul que `yogisphuta`, sauf que les 93°20' ne sont ajoutés que si `add_yogi_longitude` vaut true ; avec cet indicateur activé, les deux champs sont donc identiques. `santanatithi` n’est pas ramené dans la plage 0–360 et peut donc être négatif. Enfin, Gulika est calculé avec un décalage fixe de +05:30, quel que soit le lieu fourni, ce qui décale tous les points qui en dérivent pour les lieux éloignés de ce fuseau.
https://api.occultapi.com/api/astro/prashna/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 |
|---|---|---|---|
| add_yogi_longitude | boolean | obligatoire | |
| 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 -180 · max 180 |
| 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 |
| name | string | obligatoire | |
| node_type | string | obligatoire | truemeanCorrespondance exacte, en minuscules. Choisit le nœud lunaire vrai ou moyen pour les calculs de sphutas. |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/prashna/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2024-11-14T11:59:23.365Z","longitude":74.319,"latitude":26.1046,"name":"RashiChart","node_type":"true","add_yogi_longitude":true}'Réponse
{
"data": {
"gulika_longitude": 243.2836111111111,
"trisphuta": {
"longitude": 277.6645540646069,
"astrological": {
"degree": 7,
"sign": "Cp",
"minutes": 39,
"seconds": 52
},
"constellation": 9,
"nakshatra": "Uttaraashaadha",
"pada": 4
},
"chatursphuta": {
"longitude": 126.06855406460689,
"astrological": {
"degree": 6,
"sign": "Le",
"minutes": 4,
"seconds": 6
},
"constellation": 4,
"nakshatra": "Makha",
"pada": 2
},
"panchasphuta": {
"longitude": 107.64255406460688,
"astrological": {
"degree": 17,
"sign": "Cn",
"minutes": 38,
"seconds": 33
},
"constellation": 3,
"nakshatra": "Aasresha",
"pada": 1
},
"pranasphuta": {
"longitude": 10.578325878590022,
"astrological": {
"degree": 10,
"sign": "Ar",
"minutes": 34,
"seconds": 41
},
"constellation": 0,
"nakshatra": "Ashwini",
"pada": 4
},
"dehasphuta": {
"longitude": 314.6596111111111,
"astrological": {
"degree": 14,
"sign": "Aq",
"minutes": 39,
"seconds": 34
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 3
},
"mrityusphuta": {
"longitude": 111.3892777777778,
"astrological": {
"degree": 21,
"sign": "Cn",
"minutes": 23,
"seconds": 21
},
"constellation": 3,
"nakshatra": "Aasresha",
"pada": 2
},
"sookshmatrisphuta": {
"longitude": 76.6272147674789,
"astrological": {
"degree": 16,
"sign": "Ge",
"minutes": 37,
"seconds": 37
},
"constellation": 2,
"nakshatra": "Aardra",
"pada": 3
},
"beejasphuta": {
"longitude": 152.48299999999995,
"astrological": {
"degree": 2,
"sign": "Vi",
"minutes": 28,
"seconds": 58
},
"constellation": 5,
"nakshatra": "Uttara Phalguni",
"pada": 2
},
"kshetrasphuta": {
"longitude": 162.847,
"astrological": {
"degree": 12,
"sign": "Vi",
"minutes": 50,
"seconds": 49
},
"constellation": 5,
"nakshatra": "Hasta",
"pada": 1
},
"tithisphuta": {
"longitude": 160.518,
"astrological": {
"degree": 10,
"sign": "Vi",
"minutes": 31,
"seconds": 4
},
"constellation": 5,
"nakshatra": "Hasta",
"pada": 1
},
"yogasphuta": {
"longitude": 310.65933333333334,
"astrological": {
"degree": 10,
"sign": "Aq",
"minutes": 39,
"seconds": 33
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 2
},
"yogisphuta": {
"longitude": 310.65933333333334,
"astrological": {
"degree": 10,
"sign": "Aq",
"minutes": 39,
"seconds": 33
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 2
},
"avayogisphuta": {
"longitude": 137.32600000000002,
"astrological": {
"degree": 17,
"sign": "Le",
"minutes": 19,
"seconds": 33
},
"constellation": 4,
"nakshatra": "Poorva Phalguni",
"pada": 2
},
"rahutithisphuta": {
"longitude": 133.17000000000002,
"astrological": {
"degree": 13,
"sign": "Le",
"minutes": 10,
"seconds": 12
},
"constellation": 4,
"nakshatra": "Makha",
"pada": 4
},
"santanatithi": {
"longitude": -83.11749999999999,
"astrological": {
"degree": 6,
"sign": "Cp",
"minutes": 52,
"seconds": 56
},
"constellation": 9,
"nakshatra": "Uttaraashaadha",
"pada": 4
}
},
"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.