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

Transit dans une maison

Des lectures prérédigées pour une planète en transit dans une maison donnée du thème natal : ce que le passage du Soleil dans la troisième maison est réputé apporter, ce qu’apporterait celui de Saturne dans la septième, etc., pour neuf planètes dans douze maisons. Une simple consultation — fournissez `planet` et `house`, et vous obtenez le texte. Aucune date, heure ni aucun lieu n’intervient : associez-le donc à un calcul qui vous indique quelle maison occupe actuellement chaque planète. Utilisez-le conjointement avec `/api/astro/planet_transit_natal_planets/`, qui couvre l’autre moitié d’un rapport de transit : le contact d’une planète en transit avec une planète natale, et non avec une maison.

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

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
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.
planet	string	obligatoire	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Correspondance exacte en minuscules. Une valeur inconnue renvoie "Invalid key: <x>" avec HTTP 200. (Le champ associé `house` est un indice entier dans une liste, à partir de 0 - voir l’exemple __main__ à.

Clés disponibles (1)

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_transit_over_house	planet, house	La lecture de `planet` en transit dans la maison indiquée par `house`. Renvoie une liste de courtes phrases, généralement deux à quatre, chacune énonçant un point distinct sur ce passage.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/planet_transit_over_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_transit_over_house"],"planet":"Sun","house":3}'

Réponse

{
  "data": {
    "get_planet_transit_over_house": [
      "Irritable temper",
      "Gains physical strength, fame, and honour"
    ]
  },
  "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.