POSThttps://api.occultapi.com/api/astro/planet_insights/

Lectures des placements planétaires

Corps de la requêteJSON

Collez une clé API ci-dessus pour envoyer.

Extrait de code

curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'

Des interprétations prérédigées pour une planète dans une position donnée. Indiquez une planète et sa position (un signe du zodiaque, une maison ou un nakshatra) : l’endpoint renvoie la lecture classique de cette combinaison. C’est une consultation dans un corpus de textes, pas un calcul : aucune date, heure ni aucun lieu n’intervient, et la même requête renvoie toujours le même texte. Utilisez-le pour légender un thème déjà calculé. Prenez le signe, la maison et le nakshatra de Jupiter dans `/api/astro/chart/`, puis appelez cet endpoint pour obtenir le texte. Les trois clés peuvent être demandées en un seul appel, mais chacune a son propre paramètre supplémentaire : `planet`, `sign`, `house` et `nakshatra` doivent donc tous figurer dans le corps si vous demandez les trois. Couverture : neuf planètes (les sept classiques plus Rahu et Ketu) dans douze signes et douze maisons. Les lectures par nakshatra n’existent que pour les sept planètes classiques — Rahu et Ketu n’en ont aucune. Pour une planète, un signe, une maison ou un nakshatra non reconnu, la réponse est une chaîne explicative avec HTTP 200, et non une erreur ; vérifiez donc le type reçu avant de l’afficher.

Champs de la requête

Champ	Type	Obligatoire	Remarques
house	integer	obligatoire
keys	array	obligatoire	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	obligatoire	`ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguni` La liste ci-dessus est celle qu’utilisent jupiter, mercury, venus et saturn. 'rahu' et 'ketu' n’ont aucune donnée de nakshatra. Les valeurs sans correspondance renvoient "Invalid nakshatra: <x> for planet <p>" avec HTTP 200.
planet	string	obligatoire	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Une planète inconnue renvoie la chaîne "Invalid planet: <x>" avec HTTP 200, et non un statut d’erreur. Notez que rahu et ketu n’ont AUCUNE donnée de nakshatra (insights['rahu']['nakshatras'] is None) ; get_planet_nakshatra_insight renvoie donc "No nakshatra data available for rahu".
sign	string	obligatoire	`ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces` BOGUE DE DONNÉES à documenter : pour planet='sun', la clé est mal orthographiée 'vigro' au lieu de 'virgo', si bien que sun+virgo renvoie "Invalid sign: virgo for planet sun" tandis que sun+vigro fonctionne. Les huit autres planètes utilisent 'virgo'.

Clés disponibles (3)

Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.

Clé	Champs supplémentaires requis	Description
get_planet_house_insight	planet, house	La lecture de `planet` placée dans une maison, `house` allant de 1 à 12. Renvoie un objet avec le libellé de la maison, un résumé et des listes de traits, ainsi que `classicalTexts` — une liste de `{heading, text}` citant Parashara, le Brihat Jataka, la Saravali et la Phaladipika sur ce placement — et `houseLordVariations`, une liste de `{ascendent, aspect, result}` qui indique comment la lecture varie pour chacun des douze ascendants. Certains champs de résumé et de traits valent null lorsque seules les citations classiques sont disponibles.
get_planet_nakshatra_insight	planet, nakshatra	La lecture de `planet` placée dans `nakshatra`, renvoyée sous forme d’une ou deux phrases de texte brut et non d’un objet structuré. Disponible pour les sept planètes classiques dans les 27 nakshatras ; Rahu et Ketu n’ont pas de lectures par nakshatra et renvoient à la place une chaîne explicative.
get_planet_sign_insight	planet, sign	La lecture de `planet` placée dans `sign`. Renvoie un objet avec `sign` (le libellé sanskrit de la combinaison, comme "Mesa Brhaspati"), un paragraphe `summary`, et les listes `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` et `drstiphala`, cette dernière décrivant les effets des aspects que la planète projette depuis cette position. Notez l’espace dans le nom du champ `core traits`.

Référence complète de cet endpoint