Aller au contenu
POST/api/astro/planet_insights/1 crédit

Lectures des placements planétaires

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.

https://api.occultapi.com/api/astro/planet_insights/
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

ChampTypeObligatoireRemarques
houseintegerobligatoire
keysarrayobligatoire

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.

nakshatrastringobligatoire
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.

planetstringobligatoire
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".

signstringobligatoire
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 requisDescription
get_planet_house_insightplanet, houseLa 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_insightplanet, nakshatraLa 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_insightplanet, signLa 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`.

Exemple de requête

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"}'

Réponse

{
  "data": {
    "get_planet_sign_insight": {
      "sign": "Mesa Brhaspati",
      "summary": "Jupiter in Aries produces a bold, authoritative, and resourceful individual with strong leadership capabilities. Aries is ruled by Mars (Maṅgala), a planet friendly to Jupiter and symbolizing courage, initiative, and battle-readiness. Jupiter here gains the spirit of a warrior-sage, combining spiritual strength with physical initiative. The placement enhances fame, wealth, power, and generational prosperity, especially through sons. However, the position also introduces difficulties like enemies, physical injuries, and excessive expenditures due to Aries being the debilitation sign for Saturn (Śani), whose tamasic qualities interfere with Jupiter's sattvic nature. The individual is splendorous, generous, and powerful, but also faces trials that temper their greatness",
      "core traits": [
        "Argumentative in disposition",
        "Acquiring precious stones and ornaments through effort",
        "Endowed with strength, sons, and wealth",
        "Eminent and famous profession",
        "Splendorous",
        "Many enemies",
        "Many expenses",
        "Injured body",
        "Confers severe and cruel punishments"
      ],
      "psychologicalPhysicalTraits": [
        "Argumentative in disposition",
        "Acquiring precious stones and ornaments through effort",
        "Endowed with strength, sons, and wealth",
        "Eminent and famous profession",
        "Splendorous",
        "Many enemies",
        "Many expenses",
        "Injured body",
        "Confers severe and cruel punishments",
        "Love of grandeur",
        "Powerful",
        "Wealthy",
        "Prudent",
        "Many children",
        "Courteous",
        "Generous",
        "Firm",
        "Sympathetic",
        "Happy marriage",
        "Patient nature",
        "Harmonious",
        "Refined",
        "High position"
      ],
      "astrologicalReasoning": [
        {
          "heading": "Initiative & Argumentation",
          "text": "Meṣa is ruled by Maṅgala, the god of war and action, endowing Jupiter with a strong fighting disposition and argumentative temperament."
        },
        {
          "heading": "Wealth & Luxuries",
          "text": "Sūrya, exalted in Meṣa, governs precious metals and gemstones. Jupiter, the Dhanakāraka, placed here results in acquiring valuables through effort."
        },
        {
          "heading": "Progeny & Strength",
          "text": "Meṣa is a masculine sign ruled by male planets (Sūrya and Maṅgala). Jupiter, as the Santana Kāraka, gains support here, indicating sons, strength, and vitality."
        },
        {
          "heading": "Fame & Eminence",
          "text": "As the 1st house of Kālapuruṣa, Aries governs fame. Jupiter's placement brings name, professional eminence, and public recognition."
        },
        {
          "heading": "Drawbacks of the Sign",
          "text": "Meṣa is Śani's debilitation sign. Jupiter here absorbs Śani's weaknesses, causing a rise in enemies (6H), injury-proneness, emotional detachment (due to 8H being Moon's debilitation), and heavy expenditure (12H effects)."
        },
        {
          "heading": "Judgement & Harshness",
          "text": "With Jupiter reflecting Maṅgala's and Śani's stern traits, the native may confer harsh or severe judgments lacking emotional nuance."
        }
      ],
      "drstiphala": [
        {
          "planet": "Sūrya",
          "aspect": "positive",
          "result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
        },
        {
          "planet": "Candra",
          "aspect": "positive",
          "result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
        },
        {
          "planet": "Maṅgala",
          "aspect": "positive",
          "result": "Belonging to a royal dynasty, fearless, fierce, endowed with political knowledge, modest, affluent, has a disobedient wife and disobedient servants."
        },
        {
          "planet": "Budha",
          "aspect": "negative",
          "result": "Liar, crafty, sinful, skilful in detecting others' flaws, serves others, grateful, modest, not outspoken."
        },
        {
          "planet": "Śukra",
          "aspect": "positive",
          "result": "Very happy with residences, sleeping comforts, robes, perfumes, garlands, ornaments, wife, very timid."
        },
        {
          "planet": "Śani",
          "aspect": "mixed",
          "result": "Talkative, eloquent, devoid of happiness, brilliant, has mean children and a mean wife."
        }
      ]
    }
  },
  "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, sous le nom de chaque clé demandée.

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.