Skip to main content
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"
}

​
Purpose

This endpoint allows you to validate:
  • Authentication - API_KEY and API_SECRET credentials
  • IP Allowlist - Verify if your IP is authorized
  • TLS Connectivity - Test secure connection
Security requirement: Fixed public IP on the allowlist. Propagation of additions/changes: up to 10 minutes.

​
Authentication

​
Authorization
string
required
Basic Auth required in format: Basic {Base64(API_KEY:API_SECRET)}

​
Response

​
requestId
string
UUID for tracking and auditing
​
success
boolean
Indicates if the request was successful
​
size
number
Number of items returned (always 1 on success)
​
message
string
Descriptive response message
​
data
string
Returns "pong" on success
{
  "requestId": "d662bce0-a94f-4af2-b420-edbe79a8741d",
  "success": true,
  "size": 1,
  "message": "Ping OK",
  "data": "pong"
}

​
Status Codes

HTTPDescription
200Valid credentials and IP on allowlist
400Malformed Authorization header
401Invalid or revoked API Key/Secret
403IP not on allowlist
429Rate limit exceeded
500Internal server error

​
Quick Diagnostics

Validate API_KEY:API_SECRET, check Base64 encoding, and confirm credentials have not been rotated.
Confirm your outbound IP is on the allowlist and wait for propagation (up to 10 minutes).
Check the Authorization header format. It should be Basic {Base64}.
Run curl -v for diagnostics, check proxy/firewall, and confirm SNI is enabled.
Always capture and report the requestId to support for easier diagnostics.