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

Transit sur une planète natale

Des lectures prérédigées pour une planète qui passe sur la position natale d’une autre planète — Saturne en transit sur la Lune natale, Jupiter en transit sur le Soleil natal, etc. C’est la table des transits par paires sur laquelle reposent la plupart des rapports de transit. C’est une simple consultation, sans aucun calcul de thème : fournissez la planète en transit dans `planet` et la planète du thème natal dans `natal_planet`, et vous obtenez le texte. Déterminez d’abord quels contacts sont réellement actifs grâce à un calcul de transit comme `/api/astro/transit/`, puis appelez cet endpoint pour obtenir le texte. Les deux arguments acceptent les neuf corps, mais Vénus manque côté planète en transit. L’ordre compte : Saturne sur le Soleil natal n’est pas la même entrée que le Soleil sur Saturne natal.

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

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
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.
natal_planet	string	obligatoire	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Correspondance exacte en minuscules. Les 9 sont présentes sous chaque planète en transit (vérifié par analyse AST de la table de correspondance). Une valeur inconnue renvoie "Invalid key: <x>" avec HTTP 200.
planet	string	obligatoire	`sunmoonmarsmercuryjupitersaturnrahuketu` REMARQUE : 'venus' est ABSENT comme planète en transit - la table de correspondance n’a que ces 8 clés de premier niveau. Une valeur inconnue renvoie "Invalid key: <x>" avec HTTP 200.

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_natal_planets	planet, natal_planet	La lecture de `planet` en transit sur la position natale de `natal_planet`. Renvoie une liste de courtes phrases, généralement deux à quatre, chacune énonçant un point distinct sur le contact. La paire est orientée : la planète en transit et la planète natale ne sont pas interchangeables.

Exemple de requête

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

Réponse

{
  "data": {
    "get_planet_transit_natal_planets": [
      "Start of a new solar cycle",
      "Brings new energy, optimism, and enthusiasm"
    ]
  },
  "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.