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}'Ashtakoota es el sistema del norte de la India que valora en ocho apartados la compatibilidad de una novia y un novio solo a partir de sus estrellas de nacimiento. Cada una de las ocho cualidades recibe una puntuación (Varna sobre 1, Vasya sobre 2, Tara sobre 3, Yoni sobre 4, Graha Maitri sobre 5, Gana sobre 6, Bhakoot sobre 7 y Nadi sobre 8), hasta un máximo de 36 puntos. En el sur de la India («porutham») se plantean casi las mismas preguntas, pero la mayoría se responden con un sí o un no, y se añaden cuatro pruebas más: Mahendra, Vedha, Rajju y Sthree Dheerga. Solo necesitas cuatro números: el nakshatra de la novia y el del novio (1–27, de Ashwini a Revati) y el pada en que cae cada uno (1–4). No hace falta hora ni lugar de nacimiento; si los tienes, usa /api/astro/horoscope-match/, que calcula la estrella por su cuenta y devuelve un informe más completo. Empieza por la clave `compatibility_score`: ejecuta todas las pruebas y las devuelve junto con el total. Dos cosas que conviene saber. El campo `method` se acepta, pero nunca llega al cálculo, así que siempre se aplica la puntuación del norte de la India; para obtener la versión sí/no del sur de una prueba, pide expresamente su clave `_south`. Y cada koota puntuado al estilo del norte devuelve una lista de dos elementos, [puntuación, máximo], no un número suelto.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| boy_nakshatra_number | integer | obligatorio | |
| boy_paadham_number | integer | obligatorio | |
| girl_nakshatra_number | integer | obligatorio | |
| girl_paadham_number | integer | obligatorio | |
| keys | array | obligatorio | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. raasi_from_nakshatra_padavarna_poruthamvasiya_poruthamvasiya_porutham_southdina_poruthamdina_porutham_southgana_poruthamgana_porutham_southyoni_poruthamyoni_porutham_southraasi_adhipathi_poruthamraasi_adhipathi_porutham_southArray de cadenas. Las variantes `_south` devuelven el mismo porutham en su forma booleana del sur de la India. |
| method | string | obligatorio | NorthSouthIMPORTANTE: `method` se declara obligatorio, pero nunca se reenvía al motor, así que siempre se usa el valor por defecto de Ashtakoota, "North", se envíe lo que se envíe. Si se reenviara, el motor buscaría la subcadena 'south' sin distinguir mayúsculas y minúsculas: 'South'/'south'/'South Indian' elegirían el método del sur y cualquier otro valor, el del norte. |
| nakshatra_number | integer | obligatorio | |
| paadha_number | integer | obligatorio | |
| use_astroyogi_method | boolean | obligatorio |
Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.
| Clave | Campos adicionales | Descripción | |
|---|---|---|---|
| compatibility_score | — | Todas las pruebas a la vez, en una lista plana de 13 entradas con este orden: Varna, Vasya, Gana, Dina, Yoni, Graha Maitri, Bhakoot y Nadi como números sueltos; luego, el total sobre 36, y después Mahendra, Vedha, Rajju y Sthree Dheerga como booleanos. Ten en cuenta que aquí las ocho primeras son puntuaciones simples, no los pares [puntuación, máximo] que devuelven las claves individuales, y que el orden no sigue el de los puntos de 1 a 8. | |
| dina_porutham | — | Dina, también llamado Tara koota: cuenta la estrella del novio desde la de la novia e interpreta la categoría de tara resultante para la salud y el bienestar. Vale 3 puntos; devuelve [puntuación, 3.0] con una puntuación de 0.0, 1.5 o 3.0. | |
| dina_porutham_south | — | La versión del sur de la India de Dina: true cuando la distancia en estrellas del novio a la novia es una de las doce que se consideran propicias (2, 4, 6, 8, 9, 11, 13, 15, 18, 20, 24, 26). Devuelve un booleano. | |
| gana_porutham | — | Gana koota, que compara los dos temperamentos (divino, humano o demoníaco) y vale 6 puntos. Devuelve [puntuación, 6] con una puntuación de 0, 1, 5 o 6. | |
| gana_porutham_south | — | La versión del sur de la India de Gana: true solo cuando las dos estrellas pertenecen al mismo gana, según las listas del sur de la India. Devuelve un booleano, así que una coincidencia parcial que en la versión del norte puntuaría 5 aquí es false. | |
| mahendra_porutham | — | Mahendra, una de las cuatro pruebas adicionales del sur de la India, relacionada con la descendencia y la duración de la unión. Es true cuando la distancia desde la estrella de la novia hasta la del novio es 4, 7, 10, 13, 16, 19, 22 o 25. Devuelve un booleano. | |
| mahendra_porutham_south | — | Idéntica a `mahendra_porutham`: la variante del sur de la India la llama directamente, así que ambas claves devuelven el mismo booleano. Pide una, no las dos. | |
| naadi_porutham | — | Nadi koota, la prueba de la constitución física. Es la de mayor peso (8 puntos) y, por tradición, un desajuste en ella no se puede pasar por alto. Devuelve [puntuación, 8] con una puntuación de 0 u 8. | |
| naadi_porutham_south | — | La versión del sur de la India de Nadi: true cuando las dos estrellas caen en nadis distintos. Devuelve un booleano, equivalente a obtener 8 en la versión del norte. | |
| raasi_adhipathi_porutham | — | Graha Maitri koota, la amistad entre los señores de los dos signos lunares, que vale 5 puntos. Devuelve [puntuación, 5.0] con una puntuación de 0, 0.5, 1, 3, 4 o 5. | |
| raasi_adhipathi_porutham_south | — | La versión del sur de la India de Graha Maitri, que se lee en una tabla propia de amistad entre señores. Devuelve el entero 0 o 1; ojo, es un número, no un booleano como la mayoría de las demás claves `_south`. | |
| raasi_from_nakshatra_pada | nakshatra_number, paadha_number | El signo lunar en el que cae un cuarto concreto de un nakshatra. Recibe `nakshatra_number` (1–27) y `paadha_number` (1–4) —son campos de la solicitud distintos de los del chico y la chica— y devuelve un único entero del 1 al 12, de Aries a Piscis. | |
| raasi_porutham | — | Bhakoot koota, que valora la distancia entre los dos signos lunares y vale 7 puntos. Devuelve [puntuación, 7] con una puntuación de 0 o 7: no hay puntuación parcial. | |
| raasi_porutham_south | — | La versión del sur de la India de Bhakoot: true justo cuando la versión del norte otorgaría los 7 puntos completos. Devuelve un booleano. | |
| rajju_porutham | — | Rajju, que asigna cada estrella a una parte del cuerpo (cabeza, cuello, estómago, cintura o pie) y se refiere a la longevidad del marido. Devuelve un booleano, true cuando ambas estrellas caen en el mismo grupo de rajju. | |
| rajju_porutham_south | — | La versión del sur de la India de Rajju, con una división más fina en ocho que separa cada parte del cuerpo en una mitad ascendente (aaroga) y otra descendente (avaroga). Devuelve un booleano y puede no coincidir con `rajju_porutham`, porque los grupos se definen de otra manera. | |
| sthree_dheerga_porutham | — | Sthree Dheerga comprueba si la estrella del novio va lo bastante por delante de la de la novia como para que el matrimonio sea duradero. Es true cuando la distancia desde la estrella de la novia hasta la del novio supera 15. Devuelve un booleano. | |
| sthree_dheerga_porutham_south | — | Idéntica a `sthree_dheerga_porutham`: la misma regla de una distancia superior a 15, devuelta como booleano. | |
| varna_porutham | — | Varna koota, la prueba de casta o de temperamento espiritual, que vale 1 punto. Devuelve [puntuación, 1], donde la puntuación es 0 o 1. | |
| vasiya_porutham | use_astroyogi_method | Vasya koota mide cuánto se siente atraído y guiado cada miembro de la pareja por el otro, y vale 2 puntos. Devuelve [puntuación, 2.0] con una puntuación de 0, 0.5, 1 o 2. Si pones `use_astroyogi_method` en true, se usa otra tabla, cuyas puntuaciones son 0, 1, 1.5 o 2. | |
| vasiya_porutham_south | — | La versión del sur de la India de Vasya: un simple true/false que indica si el signo lunar del novio es uno de los que atrae el signo de la novia. Devuelve un booleano en lugar del par [puntuación, máximo] de la versión del norte. | |
| vedha_porutham | — | Vedha, la prueba de las estrellas que se «atraviesan» entre sí. Es true cuando los dos números de estrella no suman 19, 28 ni 37, que son las parejas afligidas. Devuelve un booleano. | |
| vedha_porutham_south | — | Idéntica a `vedha_porutham`: la variante del sur de la India la llama directamente, así que ambas claves devuelven el mismo booleano. | |
| yoni_porutham | — | Yoni koota, la compatibilidad sexual e instintiva según los animales que simbolizan las dos estrellas; vale 4 puntos. Devuelve [puntuación, 4] con una puntuación entera de 0 a 4. | |
| yoni_porutham_south | — | La versión del sur de la India de Yoni: true salvo que los dos animales simbólicos formen una pareja enemiga conocida. Devuelve un booleano. |