Neverin API

Podatki Neverin v vaši kodi

Napoved, nowcast in meritve vremenskih postaj prek REST API-ja, v formatu JSON.

DokumentacijaUstvarite ključ API

Za skripte, pametni dom, spletne strani in lastne aplikacije.

Kaj ponuja API

Tri vrste podatkov, en ključ

Vremenska napoved

Napoved Neverin za vse vremenske parametre za katero koli točko na svetu. Do 14 dni vnaprej.

Nowcast padavin

Padavine za 1 do 4 ure vnaprej v 5-minutnih korakih, iz radarske slike Evrope, ki se osveži vsakih 5 minut.

Vremenske postaje

Meritve vremenskih postaj ter postaj za kakovost zraka, temperaturo morja in tla. Lastniki postaj dobijo tudi celotno zgodovino svojih meritev.

Kdo lahko uporablja API

Kaj dobite v posameznem paketu

PodatkiBrezplačnoPremium
Vaše postaje: trenutni podatki in celotna zgodovina
Napoved in nowcast
Vremenske postaje: trenutni podatki
Število zahtev
Zahteve za vaše postaje se nikoli ne štejejo.
1.000 na dan

Lastniki aktivne vremenske postaje imajo neomejeno število zahtev API za podatke svoje postaje.

Neverin Business poleg vsega naštetega ponuja zgodovino postaj, več postaj v enem klicu in bistveno večji obseg podatkov, z omejitvami, določenimi v pogodbi.

Kaj vse vključuje Premium →Neverin Business →

Kako začeti

Prvi klic v manj kot 5 minutah

1

Prijava

Prijavite se v Neverin in potrdite svoj e-poštni naslov.

2

Ključ API

V svojem Profilu v razdelku Ključi API ustvarite ključ. Prikaže se samo enkrat, zato ga takoj shranite na varno mesto.

3

Prvi klic

Ključ pošiljajte v glavi X-API-Key. Spodnji primer vrne napoved za Zagreb.

Primer
curl -H "X-API-Key: nvr_live_..." \
  "https://api.neverin.hr/v1/forecast/weather?lat=45.815&lon=15.982"

Vse končne točke, parametri in primeri odgovorov so v dokumentaciji. Odpri dokumentacijo →

Pravila

Tri pravila uporabe

Ključ je zaupen

Ne vstavljajte ga v URL ali v kodo, ki se izvaja v brskalniku, temveč API kličite s svojega strežnika. Če ključ pricurlja v javnost, ga ukinite v svojem Profilu in ustvarite novega.

Navedite vir

Ob prikazanih podatkih navedite vir iz polja meta.attribution v odgovoru.

Osebni in nekomercialni projekti

API je namenjen osebnim in nekomercialnim projektom, javni prikaz podatkov pa je dovoljen z navedbo vira. Za komercialno uporabo je treba skleniti pogodbo Business. Podatke svojih postaj uporabljajte, kakor želite.

Oglejte si celotne pogoje uporabe. Pogoji uporabe API-ja →

Pogosta vprašanja

Ali je API brezplačen?
Za lastnike postaj v omrežju Neverin da: podatki njihovih postaj so na voljo z brezplačnim računom, brez dnevne omejitve. Napoved, nowcast in druge postaje so del naročnine Premium, vse drugo pa se dogovori prek Neverin Business.
Ali preizkusno obdobje vključuje API?
Ne. V preizkusnem obdobju velja enako kot pri brezplačnem računu: ključ lahko ustvarijo lastniki postaj, za podatke svojih postaj.
Kaj se zgodi s ključem, ko Premium poteče?
Ključ ostane in še naprej deluje za vaše postaje. Napoved, nowcast in druge postaje so znova na voljo, takoj ko obnovite Premium, brez ustvarjanja novega ključa.
Koliko ključev lahko imam?
Največ tri aktivne ključe, na primer po enega za vsako integracijo. Dnevno število zahtev velja za celoten račun, ne za posamezen ključ.
Kako najdem ID postaje?
Vsaka postaja ima številčni ID, ki se nikoli ne spremeni. ID svoje postaje najdete v svojem Profilu. Druge postaje okoli dane točke, skupaj z njihovimi ID-ji, vrne končna točka /v1/stations/nearby.
Ali lahko API kličem iz JavaScripta na spletni strani?
Ne neposredno, saj bi lahko ključ v tem primeru prebral vsak, ki odpre stran. API kličite s svojega strežnika in tam shranjujte odgovore, strani pa pošiljajte samo podatke.
Neverin Business

Potrebujete več, kot je v dokumentaciji?

Prek storitve Neverin Business lahko zahtevate bistveno večji nabor podatkov od tistega, ki je opisan v dokumentaciji API-ja, vključno z zgodovino vseh postaj in podatki več postaj v enem klicu, pa tudi izdelavo sistema po meri za vaše poslovanje. Obseg, omejitve in komercialna uporaba se dogovorijo s pogodbo.

Kontaktirajte nas