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

Resolvedor de fuso horário

Transforma uma hora de nascimento no horário do relógio local e um par de coordenadas em um instante sem ambiguidade. Todos os outros endpoints desta API exigem um timestamp com fuso horário ou um deslocamento UTC numérico, e um erro aqui é a causa mais comum de mapas que saem, sem nenhum aviso, uma hora ou um dia fora. Por isso, esta costuma ser a primeira chamada que você faz. Envie `date`, `time`, `latitude` e `longitude`. As coordenadas são convertidas em um fuso horário IANA, a data e a hora sem fuso são lidas nesse fuso, e você recebe `input_datetime`, o nome do fuso resolvido em `timezone`, `localized_datetime` com o deslocamento incluído e `utc_datetime`. Passe o valor localizado direto para `date_time` nos outros endpoints. Uma ressalva: o campo da requisição se escreve `use_LMT`, mas a view lê um nome com outra grafia, então a hora média local nunca é aplicada de fato e o fuso IANA é sempre usado — `use_lmt` na resposta é sempre false. Para nascimentos anteriores à adoção local da hora padrão, calcule você mesmo o deslocamento da hora média local (quatro minutos por grau de longitude), em vez de depender desta flag.

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

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	string (date)	obrigatório	Restrição de FORMATO, não um enum. DRF DateField com formatos de entrada padrão = apenas ISO-8601: 'YYYY-MM-DD'.
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 -180 · max 180
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
time	string (time)	obrigatório	Restrição de FORMATO, não um enum. DRF TimeField com formatos de entrada padrão = apenas ISO-8601: 'HH:MM', 'HH:MM:SS' ou 'HH:MM:SS.ffffff'. O valor de exemplo do catálogo, "string", é enganoso.
use_LMT	boolean	opcional

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/date_time/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1980-09-05","time":"04:42:05.037Z","longitude":80,"latitude":23,"use_LMT":true}'

Resposta

{
  "input_datetime": "1980-09-05 04:42:05",
  "latitude": 23,
  "longitude": 80,
  "timezone": "Asia/Kolkata",
  "use_lmt": false,
  "localized_datetime": "1980-09-05T04:42:05.037000+05:30",
  "utc_datetime": "1980-09-04T23:12:05.037000+00:00"
}

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.