Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/timezone
Também disponível: 
GET https://api.bunny.build/api/v1/timezone/list

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Obtenha detalhes do fuso horário atual fornecendo um identificador IANA ou um par de coordenadas geográficas. A resposta inclui o offset UTC, status de horário de verão e a hora local atual naquele local. Use GET /timezone/list para obter todos os IDs IANA suportados.

​
Casos de uso

  • Exibir timestamps localizados em aplicativos de agendamento e calendário
  • Normalizar timestamps de logs de sistemas distribuídos para uma zona de referência única
  • Determinar o horário local no destino em aplicativos de viagem
  • Localizar elementos de UI sensíveis ao tempo, como contagens regressivas e horários comerciais

​
Corpo da requisição

Forneça timezone (ID IANA) ou lat e lon (coordenadas).
CampoTipoObrigatórioDescrição
timezonestringNãoIdentificador IANA de fuso horário (ex: "America/Sao_Paulo")
latnumberNãoLatitude para busca por coordenadas
lonnumberNãoLongitude para busca por coordenadas

​
Exemplo — por ID IANA

{
  "timezone": "America/Sao_Paulo"
}

​
Exemplo — por coordenadas

{
  "lat": -23.55,
  "lon": -46.63
}

​
Resposta

​
200 OK

CampoTipoDescrição
timezonestringIdentificador IANA do fuso horário
abbreviationstringAbreviação do fuso horário (ex: "BRT")
utc_offsetstringString de offset UTC (ex: "-03:00")
utc_offset_minutesintegerOffset UTC em minutos
current_local_timestringHora local atual no formato ISO 8601
observes_dstbooleanIndica se o fuso horário observa horário de verão atualmente
Exemplo 
{
  "timezone": "America/Sao_Paulo",
  "abbreviation": "BRT",
  "utc_offset": "-03:00",
  "utc_offset_minutes": -180,
  "current_local_time": "2025-06-21T10:30:00-03:00",
  "observes_dst": false
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Provide either 'timezone' or both 'lat' and 'lon'."
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/timezone \
  -H "X-API-Key: bun_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"timezone": "America/Sao_Paulo"}'