REST · JSON · v1

Документація

Прогнози погоди й дані про IP: один кабінет, ключі з окремими правами та зрозумілі місячні квоти.

Authorization

Передавайте ключ у заголовку Authorization. Не додавайте його до URL та не публікуйте у фронтенд-коді.

Authorization: Bearer dev_live_YOUR_KEY

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

Weather API

Поточна погода та прогноз до 16 днів: температура, опади, вітер, час сходу й заходу сонця.

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 та IPv6, країна, місто й ASN. Окремі запити та пакети до 50 адрес.

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.

Квоти й оплата

Квоти спільні для всіх ваших проєктів і ключів. Кожен API має окремий ліміт.

Місячні квоти оновлюються першого числа за UTC. Підписка поновлюється щомісяця від дати покупки. Перевищення блокується відповіддю 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.

Джерела даних

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