POST/api/astro/shashtyamsa/1 crédit

Shashtyamsa (D60)

Le shashtyamsa, le soixantième thème divisionnaire : chaque signe divisé en soixante parts de 30' chacune. La division la plus fine du shodasavarga, à laquelle la tradition accorde un grand poids. C’est aussi, de toute la série, la plus sensible à la précision de l’heure de naissance : un demi-degré correspond à environ deux minutes d’horloge ; une heure de naissance incertaine fait donc passer des planètes d’une division à l’autre et change la lecture. Tenez-la pour peu fiable tant que l’heure n’a pas été rectifiée. Renvoie la même structure plate que /api/astro/planet-positions/ : les planètes sous forme de liste dans l’ordre traditionnel, avec `name`, longitude, signe, nakshatra, pada et maison pour chacune, ainsi que l’ascendant et l’ayanamsa appliqué. Envoyez une date et un lieu ; `ayanamsa` vaut LAHIRI par défaut et les 48 sont acceptés. Le thème est fixé par la route : un `chart_name` envoyé dans le corps est donc ignoré - cet endpoint ne peut renvoyer que le thème dont il porte le nom. Pour les 24 autres divisions, utilisez /api/astro/chart/.

https://api.occultapi.com/api/astro/shashtyamsa/

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
chart_name	string	obligatoire
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.
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 -89.9 · max 89.9
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
aberration	boolean	facultatif
apply_correction	boolean	facultatif
ascendant_pos	string	facultatif	`cuspstartend`
ayanamsa	string	facultatif
background_color	string	facultatif	Couleur hexadécimale de l’arrière-plan SVG.
chart_style	string	facultatif	Style de diagramme lorsque render='svg'. 'north' est la disposition en losange, avec maisons fixes et signes tournants ; 'south' est la grille à signes fixes, avec maisons tournantes. `northsouth`
correction_deg	integer	facultatif	min 0
correction_direction	string	facultatif	`addsubtract`
correction_min	integer	facultatif	min 0 · max 59
correction_sec	integer	facultatif	min 0 · max 59
extended_bodies	array	facultatif	Groupes de corps à inclure : 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	facultatif	Manière de libeller les planètes : 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) ou 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	facultatif	Couleur hexadécimale des lignes de la grille du thème.
notation	string	facultatif	`astrologicaldegree`
nutation	boolean	facultatif
planet_color	string	facultatif	Couleur hexadécimale des libellés des planètes, p. ex. '#111827'. Par défaut : la couleur propre au thème visuel.
rahu	string	facultatif	Type de nœud à inclure. 'true' ne renvoie que les nœuds vrais, 'mean' que les nœuds moyens, 'both' renvoie les deux. `truemeanboth`
refraction	boolean	facultatif
render	string	facultatif	Mettre à 'svg' pour renvoyer aussi un diagramme du thème rendu (voir chart_style) et la géométrie qui le sous-tend. Si vous l’omettez entièrement, la réponse reste inchangée. `nonesvg`
show_degrees	boolean	facultatif	Afficher, à côté du libellé de chaque corps, son degré dans le signe.
sign_color	string	facultatif	Couleur hexadécimale des numéros et abréviations des signes.
svg_size	integer	facultatif	Largeur et hauteur du viewBox SVG carré, en pixels. min 100 · max 2000
theme	string	facultatif	`lightdark`
true_mean	string	facultatif	`TrueMean`
use_28_nakshatras	boolean	facultatif

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/shashtyamsa/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

Réponse

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 262.85,
        "latitude": 0,
        "nakshatra": "Poorvaashaadha",
        "pada": 3,
        "kakshya": "moon",
        "zodiac_name": "Sagittarius",
        "house": 5
      },
      {
        "name": "moon",
        "longitude": 88.66666666666667,
        "latitude": 4.37,
        "nakshatra": "Punarvasu",
        "pada": 3,
        "kakshya": "ascendant",
        "zodiac_name": "Gemini",
        "house": 11
      },
      {
        "name": "mars",
        "longitude": 130.48333333333335,
        "latitude": 0.535,
        "nakshatra": "Makha",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "mercury",
        "longitude": 150.4666666666667,
        "latitude": 1.574,
        "nakshatra": "Uttara Phalguni",
        "pada": 2,
        "kakshya": "saturn",
        "zodiac_name": "Virgo",
        "house": 2
      },
      {
        "name": "jupiter",
        "longitude": 178.3166666666666,
        "latitude": 0.529,
        "nakshatra": "Chitra",
        "pada": 2,
        "kakshya": "ascendant",
        "zodiac_name": "Virgo",
        "house": 2
      },
      {
        "name": "venus",
        "longitude": 87.34999999999991,
        "latitude": -3.391,
        "nakshatra": "Punarvasu",
        "pada": 3,
        "kakshya": "ascendant",
        "zodiac_name": "Gemini",
        "house": 11
      },
      {
        "name": "saturn",
        "longitude": 56.816666666666606,
        "latitude": -2.651,
        "nakshatra": "Mrigasira",
        "pada": 2,
        "kakshya": "ascendant",
        "zodiac_name": "Taurus",
        "house": 10
      },
      {
        "name": "northtruenode",
        "longitude": 273.95,
        "latitude": 0,
        "nakshatra": "Uttaraashaadha",
        "pada": 3,
        "kakshya": "jupiter",
        "zodiac_name": "Capricorn",
        "house": 6
      },
      {
        "name": "southtruenode",
        "longitude": 93.95,
        "latitude": 0,
        "nakshatra": "Pushyami",
        "pada": 1,
        "kakshya": "jupiter",
        "zodiac_name": "Cancer",
        "house": 12
      },
      {
        "name": "uranus",
        "longitude": 355.4333333333333,
        "latitude": -0.154,
        "nakshatra": "Revati",
        "pada": 3,
        "kakshya": "moon",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "neptune",
        "longitude": 175.9666666666667,
        "latitude": -1.412,
        "nakshatra": "Chitra",
        "pada": 1,
        "kakshya": "moon",
        "zodiac_name": "Virgo",
        "house": 2
      },
      {
        "name": "pluto",
        "longitude": 106.73333333333336,
        "latitude": -4.3,
        "nakshatra": "Aasresha",
        "pada": 1,
        "kakshya": "venus",
        "zodiac_name": "Cancer",
        "house": 12
      }
    ],
    "ascendant": {
      "longitude": 131.26666666666677,
      "zodiac_name": "Leo",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "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.