/api/astro/compatibility_match/1 créditoBusca de estrela do parceiro
Uma consulta reversa sobre uma tabela pré-calculada com todas as 11,664 combinações de estrela e pada de noiva e noivo. Em vez de pontuar um casal, ela responde à pergunta inversa: dados a estrela de nascimento e o pada de uma pessoa, quais estrelas e padas formam uma boa combinação? Fixe a estrela do noivo para obter as noivas que combinam com ele, ou a da noiva para obter os noivos. Cada linha retornada é `[star, pada, [the koota scores], score, [the supplementary tests]]`. Defina `method` como qualquer valor que contenha 'south' para buscar na tabela sul-indiana em vez da norte-indiana. Dois comportamentos pegam de surpresa, então planeje-se para eles. `minimum_score` é comparado com a coluna Nadi, e não com o total de 36 pontos, e Nadi só vale 0 ou 8; além disso, um `minimum_score` igual a 0 é tratado como 'não informado' e cai no padrão de 18 na tabela do norte ou 16 na do sul. Na prática, os padrões retornam uma lista vazia, e você precisa de um valor menor ou igual a 8 e diferente de 0 para receber alguma linha. Da mesma forma, cada uma das quatro flags de `advanced_checks` é lida uma coluna à esquerda do teste que ela nomeia: 'mahendra' filtra pela pontuação total e não encontra nada, enquanto 'vedha', 'rajju' e 'shree' filtram por Mahendra, Vedha e Rajju, respectivamente. Para pontuar um único casal, use /api/astro/ashtakoota/.
https://api.occultapi.com/api/astro/compatibility_match/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/jsonCampos da requisição
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| boy_nakshatra | integer | obrigatório | |
| boy_paadham | integer | obrigatório | |
| girl_nakshatra | integer | obrigatório | |
| girl_paadham | integer | obrigatório | |
| method | string | obrigatório | NorthSouthNÃO diferencia maiúsculas de minúsculas e usa correspondência por SUBSTRING: qualquer valor que contenha 'south' seleciona o conjunto de dados sul-indiano (all_nak_pad_boy_girl_south.csv), com minimum_score padrão de 16; qualquer outro valor seleciona o conjunto de dados do norte, com minimum_score padrão de 18. Encaminhado em. |
| minimum_score | integer | obrigatório | |
| advanced_checks | object | opcional | mahendravedharajjushreeOBJETO cujas CHAVES são restritas (os valores são booleanos). As chaves são comparadas sem diferenciar maiúsculas de minúsculas (check.lower); qualquer chave fora deste conjunto é ignorada silenciosamente. |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/compatibility_match/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"boy_nakshatra":1,"boy_paadham":1,"girl_nakshatra":5,"girl_paadham":2,"method":"South","minimum_score":0,"advanced_checks":{"mahendra":true,"vedha":true,"rajju":true,"shree":true}}'Resposta
{
"data": {
"compatibility_matcher": []
},
"message": "successful",
"is_error": false
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.
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.