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

Compatibilité Ashtakoota (Gun Milan)

L’Ashtakoota est le système nord-indien en huit critères qui évalue la compatibilité d’une mariée et d’un marié à partir de leurs seuls nakshatras de naissance. Chaque critère reçoit un score — Varna sur 1, Vasya sur 2, Tara sur 3, Yoni sur 4, Graha Maitri sur 5, Gana sur 6, Bhakoot sur 7 et Nadi sur 8 —, pour un maximum de 36 points. La pratique sud-indienne (« porutham ») pose à peu près les mêmes questions, mais y répond le plus souvent par oui ou par non, et ajoute quatre tests : Mahendra, Vedha, Rajju et Sthree Dheerga. Vous ne fournissez que quatre nombres : le nakshatra de la mariée et celui du marié (1–27, d’Ashwini à Revati), et le pada de chacun (1–4). Ni l’heure ni le lieu de naissance ne sont nécessaires — si ce sont ces données que vous avez, utilisez /api/astro/horoscope-match/, qui détermine lui-même le nakshatra et renvoie un rapport plus complet. Commencez par la clé `compatibility_score` : elle exécute tous les tests et les renvoie avec le total. Deux points à savoir. Le champ `method` est accepté mais n’est jamais transmis au calcul : c’est donc toujours le barème nord-indien qui s’applique. Pour obtenir la forme sud-indienne oui/non d’un test, demandez explicitement sa clé `_south`. Par ailleurs, les kootas notés selon la forme nord-indienne renvoient chacun une liste de deux éléments [score, maximum], et non un simple nombre.

https://api.occultapi.com/api/astro/ashtakoota/

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
boy_nakshatra_number	integer	obligatoire
boy_paadham_number	integer	obligatoire
girl_nakshatra_number	integer	obligatoire
girl_paadham_number	integer	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. `raasi_from_nakshatra_padavarna_poruthamvasiya_poruthamvasiya_porutham_southdina_poruthamdina_porutham_southgana_poruthamgana_porutham_southyoni_poruthamyoni_porutham_southraasi_adhipathi_poruthamraasi_adhipathi_porutham_south` Tableau de chaînes. Les variantes `_south` renvoient la forme booléenne sud-indienne du même porutham.
method	string	obligatoire	`NorthSouth` IMPORTANT : `method` est déclaré obligatoire par mais n’est jamais transmis au moteur, si bien que la valeur par défaut de l’Ashtakoota, "North", est toujours utilisée, quoi qu’on envoie. Sémantique du moteur s’il était transmis : test de sous-chaîne insensible à la casse sur 'south', de sorte que 'South'/'south'/'South Indian' sélectionnent la méthode sud-indienne et que toute autre valeur signifie nord-indienne.
nakshatra_number	integer	obligatoire
paadha_number	integer	obligatoire
use_astroyogi_method	boolean	obligatoire

Clés disponibles (25)

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
compatibility_score	—	Tous les tests à la fois, sous forme de liste plate de 13 entrées dans cet ordre : Varna, Vasya, Gana, Dina, Yoni, Graha Maitri, Bhakoot et Nadi sous forme de simples nombres, puis le total sur 36, puis Mahendra, Vedha, Rajju et Sthree Dheerga sous forme de booléens. Notez que les huit premiers sont ici de simples scores, et non les paires [score, maximum] que renvoient les clés individuelles, et que l’ordre n’est pas celui des points de 1 à 8.
dina_porutham	—	Dina, aussi appelé Tara koota — compte le nakshatra du marié à partir de celui de la mariée et en déduit la catégorie de tara, interprétée pour la santé et le bien-être. Vaut 3 points ; renvoie [score, 3.0] avec un score de 0.0, 1.5 ou 3.0.
dina_porutham_south	—	La forme sud-indienne de Dina : vaut true lorsque le décompte des nakshatras, du marié à la mariée, figure parmi les douze décomptes réputés propices (2, 4, 6, 8, 9, 11, 13, 15, 18, 20, 24, 26). Renvoie un booléen.
gana_porutham	—	Gana koota, qui compare les deux tempéraments — divin, humain ou démoniaque — et vaut 6 points. Renvoie [score, 6] avec un score de 0, 1, 5 ou 6.
gana_porutham_south	—	La forme sud-indienne de Gana : vaut true uniquement si les deux nakshatras appartiennent au même gana, d’après les listes sud-indiennes. Renvoie un booléen : une correspondance partielle, qui obtiendrait 5 dans la forme nord-indienne, vaut donc false ici.
mahendra_porutham	—	Mahendra, l’un des quatre tests sud-indiens supplémentaires, qui porte sur la descendance et la solidité de l’union. Vaut true lorsque le décompte du nakshatra de la mariée à celui du marié est de 4, 7, 10, 13, 16, 19, 22 ou 25. Renvoie un booléen.
mahendra_porutham_south	—	Identique à `mahendra_porutham` — la variante sud-indienne se contente de l’appeler, et les deux clés renvoient le même booléen. Demandez l’une ou l’autre, pas les deux.
naadi_porutham	—	Nadi koota, le test de constitution, le plus lourd du barème avec 8 points ; traditionnellement, une incompatibilité sur ce critère ne se rattrape pas. Renvoie [score, 8] avec un score de 0 ou 8.
naadi_porutham_south	—	La forme sud-indienne de Nadi : vaut true lorsque les deux nakshatras relèvent de nadis différentes. Renvoie un booléen, l’équivalent d’un score de 8 dans la forme nord-indienne.
raasi_adhipathi_porutham	—	Graha Maitri koota, l’amitié entre les maîtres des deux signes lunaires, qui vaut 5 points. Renvoie [score, 5.0] avec un score de 0, 0.5, 1, 3, 4 ou 5.
raasi_adhipathi_porutham_south	—	La forme sud-indienne de Graha Maitri, tirée d’une table d’amitié entre maîtres distincte. Renvoie l’entier 0 ou 1 — c’est donc un nombre, et non un booléen comme la plupart des autres clés `_south`.
raasi_from_nakshatra_pada	nakshatra_number, paadha_number	Le signe lunaire où se trouve un quart de nakshatra donné. Prend `nakshatra_number` (1–27) et `paadha_number` (1–4) — attention, ce sont des champs de la requête distincts de ceux du garçon et de la fille — et renvoie un seul entier, 1–12, du Bélier aux Poissons.
raasi_porutham	—	Bhakoot koota, qui évalue la distance entre les deux signes lunaires et vaut 7 points. Renvoie [score, 7] avec un score de 0 ou de 7 — il n’y a pas de note intermédiaire.
raasi_porutham_south	—	La forme sud-indienne de Bhakoot : vaut true exactement lorsque la forme nord-indienne accorderait les 7 points. Renvoie un booléen.
rajju_porutham	—	Rajju, qui associe chaque nakshatra à une partie du corps (tête, cou, ventre, taille ou pied) et porte sur la longévité du mari. Renvoie un booléen, qui vaut true lorsque les deux nakshatras relèvent du même groupe de rajju.
rajju_porutham_south	—	La forme sud-indienne de Rajju, fondée sur une division plus fine en huit groupes, où chaque partie du corps se scinde en une moitié ascendante (aaroga) et une moitié descendante (avaroga). Renvoie un booléen, qui peut différer de `rajju_porutham` puisque les groupes ne sont pas découpés de la même façon.
sthree_dheerga_porutham	—	Sthree Dheerga, qui vérifie si le nakshatra du marié est assez loin devant celui de la mariée pour que le mariage dure. Vaut true lorsque le décompte du nakshatra de la mariée à celui du marié dépasse 15. Renvoie un booléen.
sthree_dheerga_porutham_south	—	Identique à `sthree_dheerga_porutham` — la même règle du décompte supérieur à 15, renvoyée sous forme de booléen.
varna_porutham	—	Varna koota, le test de caste ou de tempérament spirituel, qui vaut 1 point. Renvoie [score, 1], avec un score de 0 ou 1.
vasiya_porutham	use_astroyogi_method	Vasya koota, qui mesure à quel point chaque partenaire est attiré par l’autre et se laisse guider par lui ; vaut 2 points. Renvoie [score, 2.0] avec un score de 0, 0.5, 1 ou 2. Si `use_astroyogi_method` vaut true, une autre table s’applique, avec des scores de 0, 1, 1.5 ou 2.
vasiya_porutham_south	—	La forme sud-indienne de Vasya : un simple true/false indiquant si le signe lunaire du marié fait partie des signes qu’attire celui de la mariée. Renvoie un booléen au lieu de la paire [score, maximum] de la forme nord-indienne.
vedha_porutham	—	Vedha, le test des nakshatras qui se « percent » mutuellement. Vaut true lorsque la somme des deux numéros de nakshatra n’est ni 19, ni 28, ni 37, les combinaisons affligées. Renvoie un booléen.
vedha_porutham_south	—	Identique à `vedha_porutham` — la variante sud-indienne se contente de l’appeler, et les deux clés renvoient le même booléen.
yoni_porutham	—	Yoni koota, la compatibilité sexuelle et instinctive entre les symboles animaux des deux nakshatras ; vaut 4 points. Renvoie [score, 4] avec un score entier de 0 à 4.
yoni_porutham_south	—	La forme sud-indienne de Yoni : vaut true sauf si les deux symboles animaux forment une paire d’ennemis connue. Renvoie un booléen.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/ashtakoota/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["raasi_from_nakshatra_pada"],"boy_nakshatra_number":5,"boy_paadham_number":3,"girl_nakshatra_number":12,"girl_paadham_number":2,"method":"North","nakshatra_number":0,"paadha_number":0,"use_astroyogi_method":true}'

Réponse

{
  "data": {
    "raasi_from_nakshatra_pada": 1
  },
  "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.