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}'O Ashtakoota é o esquema norte-indiano de oito partes para avaliar a compatibilidade entre noiva e noivo apenas pelas estrelas de nascimento. Cada uma das oito qualidades recebe uma pontuação — Varna (máximo 1), Vasya (máximo 2), Tara (máximo 3), Yoni (máximo 4), Graha Maitri (máximo 5), Gana (máximo 6), Bhakoot (máximo 7) e Nadi (máximo 8) —, num total máximo de 36 pontos. A prática sul-indiana ('porutham') faz praticamente as mesmas perguntas, mas responde à maioria delas com sim ou não e acrescenta mais quatro testes: Mahendra, Vedha, Rajju e Sthree Dheerga. Você informa apenas quatro números: o nakshatra da noiva e o do noivo (1–27, de Ashwini a Revati) e o pada de cada um (1–4). Não é preciso hora nem local de nascimento — se você tiver esses dados, use /api/astro/horoscope-match/, que determina a estrela sozinho e retorna um relatório mais completo. Comece pela chave `compatibility_score`: ela executa todos os testes e os retorna com o total. Dois pontos de atenção. O campo `method` é aceito, mas nunca chega ao cálculo, então a pontuação norte-indiana é sempre usada; para obter a forma sul-indiana (sim/não) de um teste, solicite explicitamente a chave `_south` correspondente. E cada koota pontuado na forma norte retorna uma lista de dois elementos [pontuação, máximo], não um número isolado.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| boy_nakshatra_number | integer | obrigatório | |
| boy_paadham_number | integer | obrigatório | |
| girl_nakshatra_number | integer | obrigatório | |
| girl_paadham_number | integer | obrigatório | |
| keys | array | obrigatório | Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas. raasi_from_nakshatra_padavarna_poruthamvasiya_poruthamvasiya_porutham_southdina_poruthamdina_porutham_southgana_poruthamgana_porutham_southyoni_poruthamyoni_porutham_southraasi_adhipathi_poruthamraasi_adhipathi_porutham_southArray de strings. As variantes `_south` retornam a forma booleana sul-indiana do mesmo porutham. |
| method | string | obrigatório | NorthSouthIMPORTANTE: `method` é declarado obrigatório por, mas nunca o encaminha ao motor, então o padrão do Ashtakoota "North" é sempre usado, não importa o que seja enviado. Semântica do motor, se fosse encaminhado: teste de substring para 'south' sem diferenciar maiúsculas de minúsculas, então 'South'/'south'/'South Indian' selecionam o método sul-indiano e qualquer outro valor significa o norte-indiano. |
| nakshatra_number | integer | obrigatório | |
| paadha_number | integer | obrigatório | |
| use_astroyogi_method | boolean | obrigatório |
Liste em keys só os cálculos que você quer. Uma chave desconhecida faz a requisição inteira ser rejeitada. O custo é 1 crédito, não importa quantas chaves você peça — então agrupe tudo numa chamada só.
| Chave | Campos extras exigidos | Descrição | |
|---|---|---|---|
| compatibility_score | — | Todos os testes de uma vez, como uma lista plana de 13 entradas nesta ordem: Varna, Vasya, Gana, Dina, Yoni, Graha Maitri, Bhakoot e Nadi como números isolados, depois o total (máximo 36) e, por fim, Mahendra, Vedha, Rajju e Sthree Dheerga como booleanos. Observe que aqui as oito primeiras são pontuações simples, e não os pares [pontuação, máximo] que as chaves individuais retornam, e que a ordem não segue a escala de 1 a 8 pontos. | |
| dina_porutham | — | Dina, também chamado Tara koota — conta a estrela do noivo a partir da estrela da noiva e usa a categoria de tara resultante para avaliar saúde e bem-estar. Vale 3 pontos; retorna [pontuação, 3.0] com pontuação de 0.0, 1.5 ou 3.0. | |
| dina_porutham_south | — | A forma sul-indiana de Dina: true quando a contagem de estrelas do noivo até a noiva é uma das doze contagens consideradas auspiciosas (2, 4, 6, 8, 9, 11, 13, 15, 18, 20, 24, 26). Retorna um booleano. | |
| gana_porutham | — | Gana koota, que compara os dois temperamentos — divino, humano ou demoníaco — e vale 6 pontos. Retorna [pontuação, 6] com pontuação de 0, 1, 5 ou 6. | |
| gana_porutham_south | — | A forma sul-indiana de Gana: true apenas quando as duas estrelas pertencem ao mesmo gana, segundo as listas de pertencimento sul-indianas. Retorna um booleano, então uma correspondência parcial que pontuaria 5 na forma norte é false aqui. | |
| mahendra_porutham | — | Mahendra, um dos quatro testes sul-indianos extras, relativo à descendência e à durabilidade da união. É true quando a contagem da estrela da noiva até a do noivo é 4, 7, 10, 13, 16, 19, 22 ou 25. Retorna um booleano. | |
| mahendra_porutham_south | — | Idêntico a `mahendra_porutham` — a variante sul-indiana delega diretamente a ele, então as duas chaves retornam o mesmo booleano. Solicite uma, não as duas. | |
| naadi_porutham | — | Nadi koota, o teste constitucional de maior peso, com 8 pontos; pela tradição, uma incompatibilidade nele não admite contra-argumento. Retorna [pontuação, 8] com pontuação de 0 ou 8. | |
| naadi_porutham_south | — | A forma sul-indiana de Nadi: true quando as duas estrelas caem em nadis diferentes. Retorna um booleano, equivalente a uma pontuação de 8 na forma norte. | |
| raasi_adhipathi_porutham | — | Graha Maitri koota, a amizade entre os senhores dos dois signos lunares, que vale 5 pontos. Retorna [pontuação, 5.0] com pontuação de 0, 0.5, 1, 3, 4 ou 5. | |
| raasi_adhipathi_porutham_south | — | A forma sul-indiana de Graha Maitri, lida de uma tabela separada de amizade entre os senhores. Retorna o inteiro 0 ou 1 — observe que é um número, não um booleano como a maioria das outras chaves `_south`. | |
| raasi_from_nakshatra_pada | nakshatra_number, paadha_number | O signo lunar em que cai um determinado quarto de nakshatra. Recebe `nakshatra_number` (1–27) e `paadha_number` (1–4) — observe que são campos da requisição distintos dos campos boy/girl — e retorna um único inteiro de 1 a 12, de Áries a Peixes. | |
| raasi_porutham | — | Bhakoot koota, que avalia a distância entre os dois signos lunares e vale 7 pontos. Retorna [pontuação, 7] com pontuação de 0 ou 7 — não há pontuação parcial. | |
| raasi_porutham_south | — | A forma sul-indiana de Bhakoot: true exatamente quando a forma norte daria os 7 pontos completos. Retorna um booleano. | |
| rajju_porutham | — | Rajju, que associa cada estrela a uma parte do corpo (cabeça, pescoço, estômago, cintura ou pé) e diz respeito à longevidade do marido. Retorna um booleano, true quando as duas estrelas caem no mesmo grupo de rajju. | |
| rajju_porutham_south | — | A forma sul-indiana de Rajju, que usa a divisão óctupla mais fina, na qual cada parte do corpo se divide em metades ascendente (aaroga) e descendente (avaroga). Retorna um booleano e pode divergir de `rajju_porutham`, porque os grupos são formados de outra maneira. | |
| sthree_dheerga_porutham | — | Sthree Dheerga, que avalia se a estrela do noivo está suficientemente à frente da estrela da noiva para que o casamento seja duradouro. É true quando a contagem da estrela da noiva até a do noivo passa de 15. Retorna um booleano. | |
| sthree_dheerga_porutham_south | — | Idêntico a `sthree_dheerga_porutham` — a mesma regra da contagem acima de 15, retornada como booleano. | |
| varna_porutham | — | Varna koota, o teste de casta ou de temperamento espiritual, que vale 1 ponto. Retorna [pontuação, 1], em que a pontuação é 0 ou 1. | |
| vasiya_porutham | use_astroyogi_method | Vasya koota, que mede o quanto cada parceiro é atraído e conduzido pelo outro e vale 2 pontos. Retorna [pontuação, 2.0] com pontuação de 0, 0.5, 1 ou 2. Com `use_astroyogi_method` definido como true, entra uma tabela alternativa, cujas pontuações são 0, 1, 1.5 ou 2. | |
| vasiya_porutham_south | — | A forma sul-indiana de Vasya: um simples true/false que indica se o signo lunar do noivo está entre os que o signo da noiva atrai. Retorna um booleano em vez do par [pontuação, máximo] da forma norte. | |
| vedha_porutham | — | Vedha, o teste das estrelas que se 'perfuram' mutuamente. É true quando os números das duas estrelas não somam 19, 28 nem 37, que são os pareamentos aflitos. Retorna um booleano. | |
| vedha_porutham_south | — | Idêntico a `vedha_porutham` — a variante sul-indiana delega diretamente a ele, então as duas chaves retornam o mesmo booleano. | |
| yoni_porutham | — | Yoni koota, a compatibilidade sexual e instintiva dos símbolos animais das duas estrelas, que vale 4 pontos. Retorna [pontuação, 4] com pontuação inteira de 0 a 4. | |
| yoni_porutham_south | — | A forma sul-indiana de Yoni: true, a menos que os dois símbolos animais formem um par inimigo conhecido. Retorna um booleano. |