Carregando o Playground
curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"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.
| 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. |