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

Cuspides des maisons

Les douze divisions des maisons pour un moment et un lieu, dans le système de maisons de votre choix. La pratique védique prend généralement les signes entiers comme maisons, mais cet endpoint propose tous les systèmes du moteur d’éphémérides — Placidus, Koch, Campanus, Regiomontanus, Sripati, Porphyre, maisons égales et signes entiers, entre autres, soit deux douzaines — pour que vous puissiez dresser le même thème dans le système qu’attend une tradition donnée. Les positions sont sidérales. Il faut bien distinguer cuspide et étendue. La cuspide est le degré unique que le système attribue à une maison ; l’étendue est l’intervalle que la maison occupe réellement, calculé ici à partir des points médians entre cuspides voisines : une maison commence à mi-chemin de la cuspide précédente et se termine à mi-chemin de la suivante. `house_cusps` donne les douze cuspides, `house_starts` et `house_ends` les deux bords, `house_ranges` les deux bords ensemble, et `houses` les trois à la fois. `notation` détermine les unités de toute la réponse : 'degree' pour des degrés décimaux bruts le long de l’écliptique, 'astrological' pour le signe suivi des degrés, minutes et secondes. `method_name` est sensible à la casse et plusieurs valeurs contiennent des espaces ou de la ponctuation : recopiez-les à l’identique. Le système défini par `method_name` est déjà appliqué à la construction de la requête : `set_house_method` et `change_house_system` ne servent donc qu’à changer de système au cours d’un appel à plusieurs clés.

https://api.occultapi.com/api/astro/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
date_time	string (date-time)	obligatoire	Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. Contrainte de FORMAT. DateTimeField DRF : ISO-8601 uniquement (formats d’entrée par défaut de DRF), p. ex. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sans fuseau = UTC supposé).
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. `set_house_methodhouseshouse_rangeshouse_startshouse_cuspshouse_endschange_house_system` Tableau de chaînes. 'set_house_method' et 'change_house_system' utilisent `method_name` ; les cinq autres utilisent `notation`.
method_name	string	obligatoire	`equalalcabitiuscampanusequal (mc)carter poli-equ.gauquelin sectorshorizon/azimutsunshinesavard-akochpullen sdmorinus` Sensible à la casse, en minuscules. Plusieurs valeurs contiennent des espaces, des barres obliques ou de la ponctuation - recopiez-les à l’identique, p. ex. 'equal (mc)', 'carter poli-equ.', 'horizon/azimut'.
notation	string	obligatoire	`astrologicaldegree` Sensible à la casse, en minuscules. 'degree' renvoie des degrés décimaux bruts ; 'astrological' renvoie le signe + d/m/s. Toute autre valeur renvoie une erreur 400.
timezone_as_float	number (double)	obligatoire	Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14
latitude	number (double)	facultatif	Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9
longitude	number (double)	facultatif	Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180

Clés disponibles (7)

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
change_house_system	method_name	Même opération que `set_house_method` : passe au système indiqué dans `method_name` et renvoie null. Les deux clés exécutent le même code ; elles sont strictement équivalentes.
house_cusps	notation	Les douze cuspides des maisons telles que les définit le système choisi, sous forme de liste plate dans l’ordre des maisons. Ce sont les degrés des cuspides eux-mêmes, et non les limites des maisons — celles-ci figurent dans `house_starts` et `house_ends`, à mi-chemin entre deux cuspides consécutives.
house_ends	notation	Seulement le bord de fin de chaque maison, sous forme de liste plate de douze valeurs dans l’ordre des maisons. Chaque valeur est le point médian entre la cuspide de cette maison et la suivante : la fin de la maison n correspond donc au début de la maison n+1.
house_ranges	notation	L’étendue de chaque maison, sous forme d’objet dont les clés vont de '1' à '12', avec `start` et `end` pour chacune. Les bords sont les points médians entre cuspides voisines : une maison commence donc à mi-chemin de la cuspide précédente et se termine à mi-chemin de la suivante. En notation 'degree', les valeurs sont des degrés décimaux ; en 'astrological', des objets signe, degrés, minutes et secondes.
house_starts	notation	Seulement le bord de début de chaque maison, sous forme de liste plate de douze valeurs dans l’ordre des maisons — et non d’un objet indexé par numéro de maison comme pour `house_ranges`. Degrés décimaux en notation 'degree', objets signe et d/m/s en 'astrological'.
houses	notation	Douze maisons avec les clés `1` à `12`, chacune de la forme `{start, cusp, end}` - les deux limites et la cuspide entre elles. Attention, la structure diffère de celle de la clé `houses` de /api/astro/krishnamurti/, qui renvoie `{start, mid, end}`, sans cuspide. `notation` détermine les unités : `degree` donne des nombres décimaux, `astrological` des chaînes comme `"Aries 12 30 15"`.
set_house_method	method_name	Recalcule les cuspides selon le système de maisons indiqué dans `method_name`. Un commutateur, pas une valeur — il renvoie null et n’affecte que les clés listées après lui dans le tableau. Le système défini par `method_name` est déjà appliqué à la construction de la requête : cette clé ne sert donc que si vous changez de système en cours d’appel.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["set_house_method"],"latitude":26.9124,"longitude":26.1046,"timezone_as_float":5.5,"method_name":"equal","notation":"astrological","date_time":"2024-11-18"}'

Réponse

{
  "data": {
    "set_house_method": null
  },
  "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.