REST · JSON · v1

Documentation

Weather forecasts and IP intelligence with one account, scoped keys and clear monthly limits.

Authorization

Send your key in the Authorization header. Never include it in a URL or publish it in frontend code.

Authorization: Bearer dev_live_YOUR_KEY

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

Weather API

Current conditions and forecasts up to 16 days. Temperature, precipitation, wind and daily sunrise and sunset.

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…

IP API

IPv4 and IPv6 geolocation, country, city and ASN. Single lookups and batches of up to 50 addresses.

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 and billing

Quotas are shared across all your projects and keys, with a separate allowance for each API.

Monthly quotas reset on the first day of the UTC calendar month. Subscriptions renew monthly from purchase. Excess requests are blocked with 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.

Data sources

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