Neverin API

Neverin podaci u vašem kodu

Prognoza, nowcast i mjerenja s meteoroloških postaja preko REST API-ja, u JSON formatu.

Za skripte, kućnu automatizaciju, web stranice i vlastite aplikacije.

Što API nudi

Tri vrste podataka, jedan ključ

Vremenska prognoza

Neverin prognoza za sve vremenske parametre za bilo koju točku na svijetu. Do 14 dana unaprijed.

Nowcast oborine

Oborina za idućih 1 do 4 sata u koracima od 5 minuta, iz radarske slike Europe koja se osvježava svakih 5 minuta.

Meteorološke postaje

Mjerenja meteoroloških postaja, postaja za kvalitetu zraka, temperaturu mora i tlo. Vlasnici postaja dobivaju i cijelu povijest svojih mjerenja.

Tko može koristiti API

Što dobivate uz koji plan

PodaciBesplatnoPremium
Vaše postaje: trenutni podaci i cijela povijest
Prognoza i nowcast
Meteorološke postaje: trenutni podaci
Broj zahtjeva
Zahtjevi za vaše postaje nikad se ne broje.
1.000 dnevno

Vlasnici aktivne meteorološke postaje imaju neograničeni broj API zahtjeva za dohvat podataka njihove postaje.

Neverin Business uz sve navedeno nudi povijest postaja, više postaja u jednom pozivu i znatno veći opseg podataka, s ograničenjima prema ugovoru.

Što sve uključuje Premium →Neverin Business →

Kako započeti

Prvi poziv u manje od 5 minuta

1

Prijava

Prijavite se u Neverin i potvrdite svoju e-mail adresu.

2

API ključ

U Profilu, u odjeljku API ključevi, izradite ključ. Prikazuje se samo jednom, zato ga odmah spremite na sigurno mjesto.

3

Prvi poziv

Ključ šaljite u zaglavlju X-API-Key. Primjer ispod vraća prognozu za Zagreb.

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

Sve rute, parametri i primjeri odgovora nalaze se u dokumentaciji. Otvori dokumentaciju →

Pravila

Tri pravila korištenja

Ključ je tajan

Ne stavljajte ga u URL ni u kod koji se izvršava u pregledniku, nego API pozivajte sa svog poslužitelja. Ako ključ procuri, opozovite ga u Profilu i izradite novi.

Navedite izvor

Uz prikazane podatke navedite izvor iz polja meta.attribution u odgovoru.

Osobni i nekomercijalni projekti

API je namijenjen osobnim i nekomercijalnim projektima, a javni prikaz podataka dopušten je uz navođenje izvora. Za komercijalnu upotrebu potrebno je sklopiti Business ugovor. Podatke svojih postaja koristite kako želite.

Pogledajte sve uvjete korištenja. Uvjeti korištenja API-ja →

Česta pitanja

Je li API besplatan?
Za vlasnike postaja u Neverin mreži jest: podaci njihovih postaja dostupni su uz besplatni račun, bez dnevnog ograničenja. Prognoza, nowcast i druge postaje dio su Premium pretplate, a sve izvan toga dogovara se kroz Neverin Business.
Uključuje li probno razdoblje API?
Ne. Tijekom probnog razdoblja vrijedi isto što i uz besplatni račun: ključ mogu izraditi vlasnici postaja, za podatke svojih postaja.
Što se događa s ključem kad Premium istekne?
Ključ ostaje i dalje radi za vaše postaje. Prognoza, nowcast i druge postaje ponovno su dostupni čim obnovite Premium, bez izrade novog ključa.
Koliko ključeva mogu imati?
Do tri aktivna ključa, primjerice po jedan za svaku integraciju. Dnevni broj zahtjeva vrijedi za cijeli račun, a ne za pojedini ključ.
Kako pronaći ID postaje?
Svaka postaja ima brojčani ID koji se nikad ne mijenja. ID vaše postaje možete pronaći unutar vašeg Profila. Druge postaje oko zadane točke, s njihovim ID-jevima, vraća ruta /v1/stations/nearby.
Mogu li API pozivati iz JavaScripta na web stranici?
Ne izravno, jer bi ključ tada mogao pročitati svatko tko otvori stranicu. API pozivajte sa svog poslužitelja i ondje spremajte odgovore, a stranici šaljite samo podatke.
Neverin Business

Trebate više od onoga što je u dokumentaciji?

Kroz Neverin Business možete zatražiti znatno veći skup podataka od onoga opisanog u API dokumentaciji, uključujući povijest svih postaja i više postaja u jednom pozivu, kao i izradu prilagođenog sustava za vaše poslovanje. Opseg, ograničenja i komercijalna upotreba dogovaraju se ugovorom.

Javite nam se