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

Atributos do mapa

Um apanhado de doze pequenas grandezas do mapa em uma única chamada — o tipo de coisa que, de outro modo, exigiria uma dúzia de requisições. As doze são sempre calculadas, não importa o que você envie. O conjunto inclui o nakshatra e o pada de uma longitude eclíptica, o número e o planeta regente de um nakshatra a partir do nome, o senhor Hadda (termo egípcio) de uma longitude dentro de um signo, o senhor Kakshya e o número Kakshya, o signo do zodíaco de uma longitude, os planetas combustos no momento informado, o ângulo de fase da Lua, a próxima ocorrência de uma fase lunar escolhida, os quatro momentos de ingresso sazonal de um ano e uma posição de mapa divisional derivada de uma longitude. Só `date_time` é obrigatório; todo o resto tem um padrão (longitude 0, name 'Ashwini', zodiac 'Aries', lord 'saturn', target_phase 0 para lua nova, limitdays 30, o ano atual, chart_factor 1 para o mapa rashi). Assim, uma chamada mínima, só com `date_time` e `longitude`, já traz planetas combustos, fase da Lua, nakshatra e signo. Duas peculiaridades: `lord` é comparado diferenciando maiúsculas de minúsculas com dados que guardam Mercúrio com inicial maiúscula, então 'mercury' retorna null silenciosamente, enquanto 'Mercury' retorna um número; e os campos da requisição `when` e `nakshatras` são aceitos, mas nunca lidos.

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

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. Restrição de FORMATO, não um enum. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC).
chart_factor	integer	opcional	Fator do mapa divisional para dasavarga_from_longitude (1=Rashi, 9=Navamsa, etc.).
limitdays	integer	opcional	Janela de busca, em dias, para search_moon_phase.
longitude	number (double)	opcional	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
lord	string	opcional	Senhor planetário usado por get_kakshya_number. `saturnjupitermarssunvenusMercurymoonascendant` Correspondência exata que DIFERENCIA maiúsculas de minúsculas. Os próprios dados são inconsistentes: sete entradas estão em minúsculas, mas Mercúrio é armazenado com inicial maiúscula, como 'Mercury', então 'mercury' retorna null silenciosamente, enquanto 'Mercury' retorna 6. Um valor sem correspondência retorna null sem erro. Padrão: 'saturn'.
nakshatras	string	opcional
name	string	opcional	Nome do nakshatra usado por get_nakshatra_details. `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` Nome do nakshatra que alimenta o resultado `nakshatra_details`. Não diferencia maiúsculas de minúsculas; espaços nas extremidades são removidos. Tanto as grafias modernas (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) quanto as transliterações mais antigas do motor (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra) são reconhecidas. 'Abhijit' é aceito (esquema de 28 nakshatras). Padrão: 'Ashwini'.
target_phase	integer	opcional	Fase da Lua a buscar: 0=nova, 1=quarto crescente, 2=cheia, 3=quarto minguante.
when	string	opcional
year	integer	opcional	Ano de nascimento como número, por exemplo 1990. Quatro dígitos.
zodiac	string	opcional	Signo do zodíaco usado por get_hadda_lord. `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/attributes/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'

Resposta

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "message": "successful",
  "is_error": false
}

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.