Aller au contenu
Occult API
POST/api/astro/house_lord_particular_house/1 crédit

Placement d’un maître de maison (une paire)

Le maître d’une maison porte les affaires de cette maison partout où il va : les textes classiques prévoient donc un énoncé précis pour chacune des 144 combinaisons — douze maîtres dans douze positions. Cet endpoint renvoie l’énoncé correspondant à une paire. Indiquez dans house la maison dont il s’agit du maître, avec les noms sanskrits de bhava propres à cet endpoint — lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya, de la première à la douzième —, et dans number la maison où ce maître est placé, de 1 à 12. Notez que /api/astro/effect_house_lord_different_house/ traite du même sujet avec d’autres noms et un autre texte ; les deux ne sont pas interchangeables. Rien n’est calculé à partir d’un thème : vous n’envoyez ni date, ni heure, ni lieu — déterminez d’abord vous-même le placement du maître. Un nom de maison inconnu ou un numéro hors plage renvoie HTTP 200 avec la chaîne 'Invalid key: …', et non un statut d’erreur. L’unique clé est get_house_lord.

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

ChampTypeObligatoireRemarques
housestringobligatoire
lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya

Le bhava dont le MAÎTRE est placé : lagna = 1re... vyaya = 12e. ATTENTION : cet endpoint utilise un jeu de noms DIFFÉRENT de /api/astro/effect_house_lord_different_house/ - ici, les 5e/6e/7e/8e/9e sont 'putra', 'satru', 'yuvati', 'randhara' (notez le 'a' en plus : randhAra) et 'dharma'. Mis en minuscules par. Une valeur inconnue renvoie 200 avec "Invalid key: <x>".

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.

get_house_lord

Tableau de chaînes ; il n’existe qu’une seule clé.

numberintegerobligatoire
123456789101112

Entier 1-12 - la maison où ce maître est placé. Une valeur hors plage renvoie 200 avec "Invalid key: <n>".

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 requisDescription
get_house_lordhouse, numberLes résultats classiques du maître d’une maison placé dans une autre : house désigne le bhava dont il est le maître, number la maison où il se trouve. Renvoie une liste de courtes affirmations en anglais, en général une à trois, comme 'Blessed with paternal and maternal happiness'. Texte de référence indexé par la paire ; rien n’est déduit d’un thème.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/house_lord_particular_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_house_lord"],"house":"lagna","number":4}'

Réponse

{
  "data": {
    "get_house_lord": [
      "Blessed with paternal and maternal happiness",
      "Gains many brothers, is charming, virtuous, and has a passionate nature"
    ]
  },
  "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.