POST/api/astro/chara-karakas/1 crédito

Chara karakas (Jaimini)

Os oito chara karakas de Jaimini, como nomes de planetas em vez de índices brutos. Os karakas classificam os planetas pelo quanto já avançaram dentro do seu signo, em ordem decrescente, com Rahu contado ao contrário porque se move para trás. O planeta que fica no topo é o Atmakaraka, o significador do eu, e todo o método de Jaimini se apoia nele. O endpoint subjacente retorna um array puro, como [4, 5, 2, 0, 1, 6, 3, 7]. Este endpoint retorna qual planeta ocupa cada karaka e o que cada karaka significa.

https://api.occultapi.com/api/astro/chara-karakas/

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
date_time	string (date-time)	obrigatório	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
latitude	number (double)	obrigatório	Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -90 · max 90
longitude	number (double)	obrigatório	Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180
timezone_as_float	number (double)	obrigatório	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14
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.
node	string	opcional
planet	string	opcional
raasi	integer	opcional	min 1 · max 12

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/chara-karakas/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-05-10T19:55:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"node":"true"}'

Resposta

{
  "data": {
    "system": "jaimini",
    "scheme": "eight_karaka",
    "karakas": [
      {
        "karaka": "atma_karaka",
        "signifies": "Self",
        "planet": "Jupiter",
        "planet_index": 4
      },
      {
        "karaka": "amatya_karaka",
        "signifies": "Career and counsel",
        "planet": "Moon",
        "planet_index": 1
      },
      {
        "karaka": "bhratri_karaka",
        "signifies": "Siblings",
        "planet": "Venus",
        "planet_index": 5
      },
      {
        "karaka": "maitri_karaka",
        "signifies": "Friends",
        "planet": "Saturn",
        "planet_index": 6
      },
      {
        "karaka": "pitri_karaka",
        "signifies": "Father",
        "planet": "Sun",
        "planet_index": 0
      },
      {
        "karaka": "putra_karaka",
        "signifies": "Children",
        "planet": "Mercury",
        "planet_index": 3
      },
      {
        "karaka": "jnaati_karaka",
        "signifies": "Kin and obstacles",
        "planet": "Mars",
        "planet_index": 2
      },
      {
        "karaka": "dara_karaka",
        "signifies": "Spouse",
        "planet": "Rahu",
        "planet_index": 7
      }
    ],
    "atma_karaka": "Jupiter"
  },
  "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.