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

Porutham (compatibilidade sul-indiana)

Compatibilidade para casamento sul-indiana: todos os doze poruthams em uma única chamada. Informe a estrela de nascimento (1-27) e o pada (1-4) dos dois parceiros. Cada porutham vem com seu resultado tradicional e sua variante sul-indiana lado a lado. Este é um sistema DIFERENTE do Ashtakoota gun milan norte-indiano, atendido por /api/astro/ashtakoota/. Os dois leem as mesmas duas estrelas de nascimento e divergem sobre o que importa, então escolha o que a sua tradição usa — a compatibilidade tâmil, telugu e kannada usa estes poruthams. Não é preciso informar horas nem locais de nascimento, e isso não é um atalho: o porutham é avaliado a partir do nakshatra e do seu quarto, então uma data seria uma entrada que o cálculo nunca lê.

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

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	min 1 · max 27
boy_paadham_number	integer	obrigatório	min 1 · max 4
girl_nakshatra_number	integer	obrigatório	min 1 · max 27
girl_paadham_number	integer	obrigatório	min 1 · max 4
keys	array	opcional	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.
method	string	opcional
nakshatra_number	integer	opcional
paadha_number	integer	opcional
use_astroyogi_method	boolean	opcional

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/porutham/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boy_nakshatra_number":5,"boy_paadham_number":3,"girl_nakshatra_number":12,"girl_paadham_number":2}'

Resposta

{
  "data": {
    "system": "porutham",
    "count": 12,
    "poruthams": [
      {
        "porutham": "varna",
        "traditional": [
          0,
          1
        ],
        "south_indian": null,
        "has_south_variant": false
      },
      {
        "porutham": "vasiya",
        "traditional": [
          1,
          2
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "dina",
        "traditional": [
          3,
          3
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "gana",
        "traditional": [
          6,
          6
        ],
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "yoni",
        "traditional": [
          1,
          4
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "raasi_adhipathi",
        "traditional": [
          5,
          5
        ],
        "south_indian": 0,
        "has_south_variant": true
      },
      {
        "porutham": "raasi",
        "traditional": [
          7,
          7
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "naadi",
        "traditional": [
          8,
          8
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "mahendra",
        "traditional": false,
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "vedha",
        "traditional": true,
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "rajju",
        "traditional": false,
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "sthree_dheerga",
        "traditional": true,
        "south_indian": true,
        "has_south_variant": true
      }
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.