/api/astro/dosha/1 créditDoshas
Un dosha est une affliction précise d’un thème natal — une configuration planétaire bien identifiée que les textes classiques considèrent comme un handicap, le plus souvent pour le mariage, la santé ou la lignée. Cet endpoint en teste huit à partir du moment et du lieu de naissance, et renvoie au choix les résultats bruts ou des explications rédigées prêtes à afficher. Il s’utilise de deux façons. Les clés individuelles (`kala_sarpa`, `manglik`, `pitru_dosha`, etc.) renvoient des résultats structurés, exploitables dans votre code. `get_dosha_details` renvoie l’ensemble sous forme de paragraphes HTML mis en forme, indexés par le nom anglais du dosha : c’est ce qu’il vous faut pour produire un rapport. Cette clé couvre Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata et Shrapit, mais pas Ganda Moola. `get_dosha_resources` fournit le corpus de textes sous-jacent, si vous préférez rédiger vos propres textes. Le sérialiseur exige tous les champs booléens et structurés de la requête, même pour les clés qui les ignorent. `manglik_reference_planet` est un indice de planète (0 Soleil, 1 Lune, 2 Mars, 3 Mercure, 4 Jupiter, 5 Vénus, 6 Saturne, 7 Rahu, 8 Ketu) ; le comportement par défaut du moteur, qui compte à partir de l’ascendant, n’est pas accessible via l’API, car le champ est typé comme entier. Sur cet endpoint, le champ du décalage UTC s’appelle `timezone`, et non `timezone_as_float`.
https://api.occultapi.com/api/astro/dosha/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 |
|---|---|---|---|
| apply_exceptions | boolean | obligatoire | |
| 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é). |
| include_2nd_house | boolean | obligatoire | |
| include_lagna_house | boolean | obligatoire | |
| 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_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsTableau de chaînes. 'manglik' nécessite manglik_reference_planet, include_lagna_house, include_2nd_house et apply_exceptions ; 'ganda_moola' nécessite moon_star ; 'get_dosha_details' nécessite date_time et geopos. |
| 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 |
| manglik_reference_planet | integer | obligatoire | |
| moon_star | string | obligatoire | Sur le fond, un NUMÉRO de nakshatra, 1-27 (les nakshatras Ganda Moola étant 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Impossible de publier une liste de valeurs acceptées qui fonctionne tant que cette incohérence de type n’est pas corrigée. |
| 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. |
Clés disponibles (10)
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 |
|---|---|---|
| ganda_moola | moon_star | Ganda Moola : indique si le nakshatra de naissance est l’un des six nakshatras de jonction (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). La clé est censée prendre le numéro de nakshatra 1–27 dans `moon_star` et renvoyer un booléen, mais le champ est typé comme chaîne alors que la liste de comparaison contient des entiers : en l’état, elle renvoie donc false quelle que soit l’entrée. |
| get_dosha_details | date_time, geopos | Les sept doshas à texte rédigé, évalués et décrits en une seule fois : un objet indexé par le nom anglais du dosha — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha et Shrapit Dosha — dont les valeurs sont des fragments HTML indiquant si le dosha est présent et ce qu’il signifie. Ganda Moola n’en fait pas partie. Nécessite `date_time` et le lieu. |
| get_dosha_resources | — | Le corpus complet des textes d’explication des doshas, sous forme d’objet indexé par nom de dosha ('kala_sarpa', 'manglik', 'pitru', 'ghata', etc.), avec une liste de paragraphes en anglais pour chacun. La première entrée de chaque liste est le texte « dosha absent », les suivantes correspondent à la maison ou à la variante concernée. Servez-vous-en pour composer votre propre texte au lieu du HTML déjà assemblé. |
| ghata | — | Ghata Dosha : Mars et Saturne réunis dans le même signe. Renvoie un seul booléen. |
| guru_chandala_dosha | — | Guru Chandala : Jupiter en conjonction avec Rahu ou Ketu dans le même signe. Renvoie une liste de deux éléments : [présence de la combinaison, Jupiter est-il le plus fort des deux]. Les deux valent false en l’absence de conjonction. |
| kala_sarpa | — | Kala Sarpa Dosha : vaut true lorsque les sept planètes classiques sont toutes enserrées entre Rahu et Ketu, d’un même côté de l’axe des nœuds. Renvoie un seul booléen ; la variante (Ananta, Kulika, Vasuki, etc.) dépend de la maison qu’occupe Rahu. |
| kalathra | — | Kalathra Dosha, l’affliction de la maison du mariage. Vaut true lorsque tous les maléfiques naturels — Soleil, Mars, Saturne, Rahu et Ketu — se trouvent dans les maisons 1, 2, 4, 7, 8 ou 12 comptées à partir de la septième maison. Renvoie un seul booléen ; comme les cinq maléfiques doivent tous remplir la condition, il vaut rarement true. |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik, ou Mangal Dosha : indique si Mars se trouve dans l’une des maisons qui affligent le mariage, comptées à partir de `manglik_reference_planet`. Renvoie une liste de trois éléments : [manglik ou non, une annulation s’applique-t-elle, numéros des règles d’annulation retenues]. Les maisons testées sont les maisons 4, 7, 8 et 12, plus la maison 2 si `include_2nd_house` vaut true et la maison 1 si `include_lagna_house` vaut true ; les annulations ne sont évaluées que si `apply_exceptions` vaut true. |
| pitru_dosha | — | Pitru Dosha, l’affliction de la lignée. Renvoie une liste de deux éléments : [true ou false, numéros des règles déclenchées]. Cinq règles sont testées dans l’ordre : un luminaire ou Rahu en maison 9, Ketu en maison 4, Soleil/Lune/Rahu/Ketu affligés par Mars ou Saturne, une concentration de Mercure, Vénus et Rahu dans les maisons 2, 5, 9 ou 12, et le Soleil ou la Lune en conjonction avec un nœud. |
| shrapit | — | Shrapit Dosha : Saturne et Rahu réunis dans le même signe. Renvoie un seul booléen. |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Réponse
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}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.