GET/api/astro/ayanamsa_value/1 crédito

Valor do ayanamsa

O ayanamsa é a diferença entre o zodíaco tropical, ligado ao equinócio, e o zodíaco sideral da astrologia védica, ligado às estrelas. Ele aumenta cerca de cinquenta segundos de arco por ano; por isso, todo cálculo sideral depende do ayanamsa adotado e da data. Este endpoint retorna esse único número. É um GET com parâmetros de consulta: `ayanamsa`, um nome como LAHIRI, RAMAN, KRISHNAMURTI ou TRUE_CITRA (são aceitas 47 definições padrão de ayanamsa, sem diferenciar maiúsculas de minúsculas), e `date`, uma data ISO cujo padrão é hoje. Use-o para indicar em um mapa o ayanamsa usado no cálculo ou para ver quanto duas definições divergem em uma data de nascimento. A resposta traz o valor das duas formas: `value_degrees` como número decimal com seis casas, e `degrees`, `minutes` e `seconds`, além de uma string `formatted` pronta para uso. O nome e a data resolvida são devolvidos na resposta. Um nome desconhecido e o pseudo-ayanamsa 'USER' retornam 400.

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

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_…

Parâmetros de query (2)

Vão na URL. Todos são opcionais, a menos que estejam marcados, e podem ser combinados — primeiro filtre, depois pagine, depois ordene.

Parâmetro	Tipo		Exemplo	Para que serve
ayanamsa	string		—	Nome do ayanamsa (por exemplo LAHIRI). Padrão: LAHIRI. Parâmetro de consulta GET. Não diferencia maiúsculas de minúsculas: .strip.upper em. Padrão: 'LAHIRI'. 'USER' é rejeitado explicitamente por este endpoint, mesmo que o motor de efemérides o reconheça. Valores desconhecidos retornam 400 {"error": "Unknown ayanamsa..."}. um destes: FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC
date	string		—	String de data ISO (por exemplo 1990-05-14). Padrão: hoje. Restrição de FORMATO, não um enum. Qualquer valor que o datetime.fromisoformat do Python aceite: 'YYYY-MM-DD' ou uma data e hora ISO 8601 completa, por exemplo '1990-05-14' / '1990-05-14T12:30:00'. Qualquer deslocamento de fuso horário na string é DESCARTADO e substituído por UTC. Padrão: hoje (UTC). Um formato inválido retorna 400.

Exemplo de requisição

curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Resposta

{
  "ayanamsa": "LAHIRI",
  "date": "2026-09-07",
  "value_degrees": 24.229844,
  "degrees": 24,
  "minutes": 13,
  "seconds": 47,
  "formatted": "24°13'47\""
}

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.