POST AI agent ready /v1/timezone

API de fuso horário - pesquisa gratuita de hora atual

Retorna a hora atual, o deslocamento UTC, a abreviatura e o status do horário de verão para um determinado fuso horário da IANA. O padrão é UTC se nenhum fuso horário for especificado.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

Exibir relógios localizados em um painel

Crie um widget de relógio com vários fusos horários para um painel de equipe. Chame esse endpoint para o fuso horário de cada membro da equipe (por exemplo, América/Nova_Iorque, Europa/Berlim, Ásia/Tóquio) e renderize a hora local atual ao lado de seu nome.

Agende notificações no horário comercial local

Antes de enviar uma notificação push ou e-mail, verifique o fuso horário do destinatário para confirmar que é entre 9h e 18h, horário local. Adie a entrega até a próxima janela comercial para melhorar as taxas de abertura e evitar interrupções fora do horário comercial.

Frequently asked questions

Qual formato de fuso horário esse endpoint aceita?

Ele aceita identificadores de fuso horário da IANA, como América/Nova Iorque, Europa/Londres ou Ásia/Tóquio. A lista completa é mantida em iana.org/time-zones.

A resposta leva em conta o horário de verão?

Sim. O campo is_dst indica se o horário de verão está ativo e utc_offset reflete o deslocamento atual, incluindo qualquer ajuste de horário de verão.

O que acontece se eu passar um fuso horário inválido?

O endpoint retorna um erro 400 com uma mensagem explicando que o identificador de fuso horário não foi reconhecido.

Posso usar isso para obter a hora UTC atual?

Sim. Omita o parâmetro de fuso horário (o padrão é UTC) ou passe explicitamente "UTC" para obter o Tempo Universal Coordenado atual.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.