/api/astro/astrocartography/lines/1 créditLignes d’astrocartographie
Toutes les lignes d’astrocartographie d’un moment de naissance, sous forme de coordonnées prêtes à tracer sur une carte. L’astrologie de relocalisation pose une question de géographie plutôt que de thème : non pas où se trouvait une planète dans le ciel, mais en quels lieux de la Terre elle se levait, se couchait, culminait ou passait au nadir au moment de la naissance. Ces quatre courbes par planète, tracées sur une carte du monde, forment la carte ACG. Vous obtenez quatre lignes pour chacun des douze corps. Les lignes MC et IC sont des méridiens : chacune se résume donc à une longitude. Les lignes AC et DC sont des courbes, renvoyées sous forme de liste de points latitude/longitude à passer directement à une polyligne — un point tous les cinq degrés de latitude par défaut, réglable avec latitude_step. Les courbes s’arrêtent là où le corps devient circumpolaire, et ce n’est pas une donnée manquante : au-delà d’une certaine latitude, le corps ne franchit plus du tout l’horizon, et il n’y a donc pas de ligne de lever à tracer. Cette limite varie d’une planète à l’autre, car elle dépend de la déclinaison. latitude et longitude ne sont facultatives que sur cet endpoint. Une ligne ACG ne dépend que du MOMENT de naissance — les formules n’utilisent que l’ascension droite, la déclinaison et le temps sidéral — et exiger un lieu de naissance laisserait croire qu’il change la réponse, ce qui n’est pas le cas. Utilisez /api/astro/astrocartography/relocate/ pour obtenir les lignes proches d’un lieu donné.
https://api.occultapi.com/api/astro/astrocartography/lines/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 |
|---|---|---|---|
| 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. |
| 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 |
| bodies | array | facultatif | Par défaut : les douze. Réduisez la liste pour alléger les réponses. |
| close_curves | boolean | facultatif | Ajouter des points qui prolongent chaque courbe AC/DC jusqu’à son extrémité : la latitude où le corps cesse de se lever et de se coucher, là où les courbes AC et DC rejoignent sa ligne MC ou IC. À activer pour le tracé ; désactivé (par défaut), seuls les échantillons régulièrement espacés sont renvoyés. |
| keys | array | facultatif | 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. |
| 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. |
| latitude_step | number (double) | facultatif | Degrés de latitude entre les points des courbes AC/DC. min 1 · max 15 |
| 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. |
| node | string | facultatif | Le nœud lunaire que représente `north_node` : true (par défaut) ou mean. truemean |
| projection | string | facultatif | mundo (par défaut) : positions vraies, latitude comprise. zodiac : positions projetées sur l’écliptique, qui correspondent 1:1 à un thème relocalisé. mundozodiac |
Exemple de requête
Exemple pas encore vérifié
Les noms et les types des champs ci-dessous viennent de la définition de l’API : ils sont exacts. En revanche, ce corps précis n’a pas abouti lors de notre dernier essai ; il lui manque peut-être une valeur que nous ne pouvons pas deviner. Prenez-le comme point de départ, pas comme une commande prête à l’emploi.
curl -X POST https://api.occultapi.com/api/astro/astrocartography/lines/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"node":"true","projection":"mundo"}'Réponse
Nous n’avons pas encore d’exemple de réponse vérifié pour cet endpoint. La structure de requête ci-dessus est générée à partir de la définition de l’API et elle est exacte ; nous ne publions un exemple de réponse qu’après l’avoir validé par un appel réel.
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.