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

Compatibilidade Ashtakoota (Gun Milan)

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.

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

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

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_south` Array de strings. As variantes `_south` retornam a forma booleana sul-indiana do mesmo porutham.
method	string	obrigatório	`NorthSouth` IMPORTANTE: `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

Chaves disponíveis (25)

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.

Exemplo de requisição

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}'

Resposta

{
  "data": {
    "raasi_from_nakshatra_pada": 1
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data, sob cada chave que você pediu.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.