REST · JSON · v1

Documentação

Previsões meteorológicas e dados IP com uma conta, chaves com permissões e limites mensais claros.

Authorization

Envie a chave no cabeçalho Authorization. Nunca a inclua num URL ou no código público do navegador.

Authorization: Bearer dev_live_YOUR_KEY

https://dev.uk.app/api/v1

API meteorológica

Condições atuais e previsão até 16 dias: temperatura, precipitação, vento, nascer e pôr do sol.

Method	Endpoint	Parameters
GET	`/weather/current`	`lat`, `lon`
GET	`/weather/forecast`	`lat`, `lon`, `days=1..16`

curl 'https://dev.uk.app/api/v1/weather/forecast?lat=50.45&lon=30.52&days=7' \
  -H 'Authorization: Bearer YOUR_API_KEY'

current, hourly, daily: temperature_2m, weather_code, wind_speed_10m, precipitation; daily: temperature_2m_max, temperature_2m_min, sunrise, sunset. timezone: UTC, auto, Europe/Kyiv…

API IP

Geolocalização IPv4 e IPv6, país, cidade e ASN. Consultas individuais e lotes até 50 endereços.

Method	Endpoint	Parameters
GET	`/ip/lookup`	`ip=1.1.1.1`
GET	`/ip/me`	Caller IP
POST	`/ip/bulk`	`{"ips":["1.1.1.1","8.8.8.8"]}`

curl 'https://dev.uk.app/api/v1/ip/lookup?ip=1.1.1.1&lang=uk' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl 'https://dev.uk.app/api/v1/ip/bulk' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-batch-001' \
  --data '{"ips":["1.1.1.1","8.8.8.8"]}'

IP geolocation is approximate. A batch accepts 1–50 public IPv4/IPv6 addresses. Invalid input rejects the whole batch without consuming monthly units. A successful batch of 50 addresses consumes 50 IP units.

Quotas e faturação

Os projetos e as chaves partilham as quotas da conta, com um limite separado para cada API.

As quotas são repostas no primeiro dia do mês civil UTC. As subscrições renovam-se mensalmente desde a compra. O excesso é bloqueado com HTTP 429.

X-Quota-Limit: 10000
X-Quota-Remaining: 9999
X-Quota-Reset: 1793491200
X-Request-ID: 00000000-0000-0000-0000-000000000000

400 invalid input · 401 invalid key · 403 API scope denied · 409 idempotency conflict · 429 quota/rate limit · 503 upstream unavailable. Quota failures include Retry-After.

Optional Idempotency-Key protects retries for the same account, API, endpoint and input. Replays are free for ten minutes. The temporarily cached response is encrypted, then deleted. Request history retains only endpoint, status, units and timing for 30 days.

Fontes de dados

Weather: Open-Meteo · IP: DB-IP Lite · CC BY 4.0. Retain attribution when displaying or redistributing data. Source information is included in API responses.

Try an API request