Assistente de Fuso Horário para Horóscopo¶

Use este assistente para obter os IDs de fuso horário IANA aceitos antes de chamar as rotas de relatórios de dias relativos (today, yesterday, tomorrow).

Ele evita erros de deslocamento de data entre regiões e garante que os usuários em diferentes geografias resolvam o dia local correto.

Endpoint¶

Método	Caminho
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

Autenticação¶

Forneça o cabeçalho da sua chave de API:

X-API-Key: YOUR_API_KEY

Parâmetros da Requisição¶

Este endpoint não requer parâmetros de consulta ou corpo.

Exemplo de Requisição¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/timezones" \
  --header "X-API-Key: YOUR_API_KEY"

Exemplo de Resposta¶

{
  "count": 596,
  "timezones": [
    "Africa/Abidjan",
    "Africa/Accra",
    "Africa/Addis_Ababa"
  ]
}

Campos da Resposta¶

Campo	Tipo	Descrição
`count`	inteiro	Número total de IDs de fuso horário aceitos retornados.
`timezones`	array de strings	Nomes de fuso horário IANA suportados.

Fluxo de Integração¶

Chame /api/v1/horoscope/timezones uma vez e armazene a lista no seu backend/cliente.
Valide o fuso horário selecionado pelo usuário contra essa lista.
Envie o fuso horário validado nas requisições de relatórios diários.

Exemplo de requisição diária com fuso horário:

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "TAURUS",
  "timezone": "America/New_York",
  "sections": ["general"]
}'

Notas¶

Utilize o formato IANA válido (por exemplo: America/New_York, Africa/Douala, Asia/Tokyo).
Evite abreviações como EST, PST ou GMT+1.
count pode variar ligeiramente dependendo do ambiente e da versão do tzdata.