/api/astro/house_information/1 créditSignifications des maisons
Chaque maison d’un thème — les douze bhavas — régit un ensemble de domaines de la vie : la quatrième le foyer et la mère, la septième les associations, la dixième la carrière. Cet endpoint renvoie la fiche de référence de l’une d’elles : ce qu’elle représente, son élément et sa qualité, les thèmes qu’elle régit, classés par rubrique, et la façon de la juger d’après son maître, les planètes qui l’occupent et ses significateurs naturels. C’est une consultation de table, pas un calcul. Vous passez house_number, de 1 à 12, et obtenez toujours le même texte — aucune date, heure ni lieu de naissance n’intervient. Servez-vous-en pour légender un thème calculé ailleurs, ou pour remplir un panneau explicatif à côté. L’unique clé est get_house_info. Un numéro hors de 1-12 renvoie la chaîne 'Invalid house number' avec HTTP 200, et non un statut d’erreur.
https://api.occultapi.com/api/astro/house_information/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/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| house_number | integer | obligatoire | 123456789101112 |
| 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. get_house_infoTableau de chaînes ; il n’existe qu’une seule clé. REMARQUE : le fichier de configuration s’appelle 'house_informations' (au pluriel), alors que la route est /api/astro/house_information/. |
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_house_info | house_number | Les significations complètes d’un bhava, choisi par house_number 1-12. Renvoie un objet avec 'other names' (son nom sanskrit, p. ex. Sukha Bhava), 'element & quality', une 'description' rédigée, 'keywords & significations' — un dictionnaire de groupes thématiques, chacun sous forme de liste d’expressions — et 'astrological info', quatre remarques sur le maître de la maison, les planètes qui y sont placées, les significateurs naturels et une règle générale pour la juger. Texte de référence statique, identique à chaque requête. |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/house_information/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_house_info"],"house_number":4}'Réponse
{
"data": {
"get_house_info": {
"other names": "Sukha Bhava",
"element & quality": "Movable, Water",
"description": "The 4th house represents comfort, emotional happiness, and inner peace. It is deeply tied to one's home, mother, vehicles, land, and personal well-being. It is also connected to learning, cultural roots, and sacred knowledge. As the house of shelter, nurturing, and support, it governs the environments that provide safety and emotional grounding.",
"keywords & significations": {
"Comfort & Happiness": [
"emotional peace",
"joy",
"contentment",
"domestic bliss",
"the source of one's sense of well-being"
],
"Mother & Maternal Side": [
"mother",
"maternal relatives",
"relationship with maternal lineage"
],
"Home & Property": [
"house",
"real estate",
"property matters",
"living space",
"entering a new home",
"ancestral property",
"loss of residence"
],
"Conveyance & Travel": [
"vehicles (rickshaws, boats, etc.)",
"means of transportation",
"local travel"
],
"Land & Agriculture": [
"land",
"agriculture",
"fertile fields",
"gardens",
"ponds and wells (including construction)",
"land arising from islands or wet zones",
"grain from wetlands"
],
"Learning & Intellect": [
"learning",
"sacred texts",
"wise counsel",
"pure intellect"
],
"Physical Comforts": [
"perfumes",
"clothing",
"ornaments",
"oil baths",
"water and drinks",
"celestial foods"
],
"Cultural & Spiritual Values": [
"castes",
"rites",
"religion-based education",
"victory in personal efforts",
"divine remedies"
],
"Family & Relations": [
"relatives",
"well-wishers",
"father",
"wife",
"friends",
"children of siblings"
],
"Security & Wealth": [
"securing of savings",
"stable financial base",
"result or conclusion of efforts"
],
"Animals & Livelihood": [
"cattle (cows, buffaloes)",
"horses",
"elephants",
"domestic animals for livelihood"
],
"Creative & Domestic Arts": [
"architecture",
"art",
"house-building skills",
"pavilions",
"layout and use of spaces"
],
"Challenges": [
"false accusations",
"loss of home",
"tiring or exhausting work"
],
"Unique Aspects": [
"trust",
"noble reputation",
"guidance in locating lost or hidden items",
"anthills"
]
},
"astrological info": {
"4th Lord (4L)": "Plays a pivotal role in determining sources of emotional comfort and security. Its placement, dignity, and the Bhava it occupies are key",
"Planets in 4H": "Influence the nature of one's peace and comforts. When placed in their own, exalted, or friendly signs, they enhance well-being. If debilitated or afflicted by challenging combinations, the associated areas may become sources of discomfort",
"Karaka Planets": "Moon – for mother and emotional nourishment; Venus – for conveyances, comforts, and pleasures; Mars – for land and property",
"General Rule": "Strong, benefic influences on the 4th house and its lord lead to happiness, prosperity at home, and mental tranquility. Affliction or weakness indicates emotional disturbances or issues related to home and domestic life"
}
}
},
"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.