Pular para o conteúdo principal
GET
https://api.owem.com.br
/
v4
/
i
/
ping
Ping
curl --request GET \
  --url https://api.owem.com.br/v4/i/ping \
  --header 'Authorization: <authorization>'
{
  "requestId": "d662bce0-a94f-4af2-b420-edbe79a8741d",
  "success": true,
  "size": 1,
  "message": "Ping OK",
  "data": "pong"
}

​
Finalidade

Este endpoint permite validar:
  • Autenticação - Credenciais API_KEY e API_SECRET
  • Allowlist de IP - Verificar se o IP está autorizado
  • Conectividade TLS - Testar conexão segura
Requisito de segurança: IP público fixo na allowlist. Propagação de inclusões/alterações: até 10 minutos.

​
Autenticação

​
Authorization
string
obrigatório
Basic Auth obrigatório no formato: Basic {Base64(API_KEY:API_SECRET)}

​
Resposta

​
requestId
string
UUID para rastreio e auditoria
​
success
boolean
Indica se a requisição foi bem-sucedida
​
size
number
Quantidade de itens retornados (sempre 1 em caso de sucesso)
​
message
string
Mensagem descritiva da resposta
​
data
string
Retorna "pong" em caso de sucesso
{
  "requestId": "d662bce0-a94f-4af2-b420-edbe79a8741d",
  "success": true,
  "size": 1,
  "message": "Ping OK",
  "data": "pong"
}

​
Códigos de Status

HTTPDescrição
200Credenciais válidas e IP na allowlist
400Header Authorization malformado
401API Key/Secret inválidos ou revogados
403IP não está na allowlist
429Rate limit excedido
500Erro interno do servidor

​
Diagnóstico Rápido

Valide API_KEY:API_SECRET, verifique o encoding Base64 e confirme se as credenciais não foram rotacionadas.
Confirme se o IP de saída está na allowlist e aguarde a propagação (até 10 minutos).
Verifique a formatação do header Authorization. O formato deve ser Basic{" "} {Base64}.
Execute curl -v para diagnóstico, verifique proxy/firewall e confirme se SNI está habilitado.
Sempre capture e informe o requestId ao suporte para facilitar o diagnóstico.