Ir para o conteúdo
POST/api/astro/kalsarp/1 crédito

Kala Sarpa yoga

Se o mapa forma Kala Sarpa — todos os sete grahas, do Sol a Saturno, confinados em um dos dois semicírculos em que o eixo Rahu–Ketu divide o zodíaco — e, se formar, qual das doze formas nomeadas ele é. A maioria dos mapas NÃO é Kala Sarpa: basta um único graha do outro lado do eixo para desfazer o yoga. Por isso, este endpoint não retorna um simples sim ou não. `between_rahu_and_ketu` e `between_ketu_and_rahu` mostram de que lado ficou cada graha, o que permite ver por que a resposta saiu assim — e é o que distingue um mapa em que só um graha escapa de outro em que escapam quatro. Os doze nomes (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag) dependem da casa que Rahu ocupa, e `name` só é preenchido quando o yoga está de fato formado — nunca para um mapa que apenas chegou perto. Um graha a menos de um grau de qualquer um dos nodos não pertence a nenhum dos lados. Esses grahas aparecem em `conjunct_a_node` e marcam `partial`, em vez de serem empurrados para um dos lados só para forçar um veredito. As posições vêm do mesmo motor de /api/astro/planet-positions/, então as longitudes são necessariamente idênticas.

https://api.occultapi.com/api/astro/kalsarp/
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

CampoTipoObrigatórioObservações
date_timestring (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.

latitudenumber (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

longitudenumber (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

ayanamsastringopcional
timezone_as_floatnumber (double)opcional

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

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/kalsarp/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Resposta

{
  "data": {
    "yoga": "Kala Sarpa",
    "formed": false,
    "partial": false,
    "name": null,
    "rahu_house": 5,
    "rahu_longitude": 283.503,
    "ketu_longitude": 103.503,
    "between_rahu_and_ketu": [
      "moon",
      "mars",
      "jupiter",
      "venus"
    ],
    "between_ketu_and_rahu": [
      "sun",
      "mercury",
      "saturn"
    ],
    "conjunct_a_node": [],
    "direction": null,
    "note": "Formed when all seven grahas fall in one of the two semicircles the Rahu-Ketu axis makes. A graha within 1.0 degree of a node is listed under conjunct_a_node rather than assigned a side, and makes the yoga partial rather than formed."
  },
  "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.