Chargement du Playground
curl -X POST https://api.occultapi.com/api/astro/general_prediction/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_prediction_details"],"date_time":"2025-07-09T10:26:45.109Z","latitude":26.9124,"longitude":75.7873,"timezone":0}'Une lecture rédigée du caractère et de la vie, construite à partir d’un thème natal : le tempérament du signe lunaire, la signification de chacune des neuf planètes dans la maison qu’elle occupe, et celle de chacun des douze maîtres de maison dans la maison où il se trouve. C’est le pendant rédigé de /api/astro/chart_analysis/, qui renvoie à peu près la même structure sous forme de données. Le texte provient de sources publiées — la section sur le signe lunaire cite How to Judge a Horoscope de B. V. Raman pour l’une des lectures et une seconde source pour l’autre —, si bien qu’un même thème produit toujours le même texte. Envoyez le moment de naissance, le lieu et le décalage UTC ; il n’y a pas d’autres options. Tout est renvoyé sous forme de fragments HTML avec titres en gras et sauts de ligne, prêts à insérer dans une page. Notez que, sur cet endpoint, le champ du décalage UTC s’appelle `timezone`, et non `timezone_as_float`.
| 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. get_prediction_detailsTableau de chaînes ; il n’existe qu’une seule clé. |
| latitude | number (double) | obligatoire | 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 -90 · max 90 |
| longitude | number (double) | obligatoire | 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 |
| timezone | number (double) | obligatoire | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30). Même signification que timezone_as_float, que d’autres endpoints désignent sous un autre nom. |
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_prediction_details | — | La lecture rédigée complète, sous forme d’objet de quatre chaînes HTML. 'Janma rasi_1' et 'Janma rasi_2' donnent deux lectures indépendantes des tendances mentales, physiques et générales du signe lunaire ; 'Planets' passe en revue les neuf planètes dans la maison qu’occupe chacune, comptée à partir de l’ascendant ; 'Houses' passe en revue les douze maîtres de maison dans la maison qu’ils occupent. Chaque valeur est un seul fragment HTML, avec des sous-titres en gras. |