Neverin API

Data Neverin ve vašem kódu

Předpověď, nowcast a měření z meteorologických stanic přes REST API ve formátu JSON.

Pro skripty, chytrou domácnost, webové stránky a vlastní aplikace.

Co API nabízí

Tři druhy dat, jeden klíč

Předpověď počasí

Předpověď Neverin všech meteorologických parametrů pro jakýkoli bod na světě. Až 14 dní dopředu.

Nowcast srážek

Srážky na 1 až 4 hodiny dopředu v 5minutových krocích, z radarového snímku Evropy, který se obnovuje každých 5 minut.

Meteorologické stanice

Měření z meteorologických stanic a ze stanic pro kvalitu ovzduší, teplotu moře a půdu. Majitelé stanic dostávají i celou historii svých měření.

Kdo může API používat

Co získáte v jednotlivých plánech

DataZdarmaPremium
Vaše stanice: aktuální data a celá historie
Předpověď a nowcast
Meteorologické stanice: aktuální data
Počet požadavků
Požadavky na vaše stanice se nikdy nezapočítávají.
1 000 denně

Majitelé aktivní meteorologické stanice mají neomezený počet API požadavků na data své stanice.

Neverin Business navíc nabízí historii stanic, více stanic v jednom volání a výrazně větší rozsah dat, s limity podle smlouvy.

Co všechno zahrnuje Premium →Neverin Business →

Jak začít

První volání za méně než 5 minut

1

Přihlášení

Přihlaste se do Neverinu a potvrďte svou e-mailovou adresu.

2

API klíč

Ve svém Profilu v sekci „API klíče“ si vytvořte klíč. Zobrazí se jen jednou, proto si ho hned uložte na bezpečné místo.

3

První volání

Klíč posílejte v hlavičce X-API-Key. Příklad níže vrací předpověď pro Záhřeb.

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

Všechny endpointy, parametry a ukázkové odpovědi najdete v dokumentaci. Otevřít dokumentaci →

Pravidla

Tři pravidla používání

Klíč je tajný

Nevkládejte ho do URL ani do kódu, který běží v prohlížeči, ale volejte API ze svého serveru. Pokud klíč unikne, zneplatněte ho ve svém Profilu a vytvořte nový.

Uveďte zdroj

U zobrazených dat uveďte zdroj z pole meta.attribution v odpovědi.

Osobní a nekomerční projekty

API je určeno pro osobní a nekomerční projekty a veřejné zobrazení dat je povoleno s uvedením zdroje. Pro komerční použití je nutné uzavřít smlouvu Business. Data svých stanic používejte, jak chcete.

Prohlédněte si úplné podmínky použití. Podmínky použití API →

Často kladené dotazy

Je API zdarma?
Pro majitele stanic v síti Neverin ano: data jejich stanic jsou dostupná s bezplatným účtem, bez denního limitu. Předpověď, nowcast a další stanice jsou součástí předplatného Premium a vše nad tento rámec se sjednává přes Neverin Business.
Zahrnuje zkušební období i API?
Ne. Během zkušebního období platí totéž jako u bezplatného účtu: klíč si mohou vytvořit majitelé stanic, a to pro data svých stanic.
Co se stane s klíčem, když Premium vyprší?
Klíč zůstává a dál funguje pro vaše stanice. Předpověď, nowcast a další stanice jsou znovu dostupné, jakmile Premium obnovíte, aniž byste museli vytvářet nový klíč.
Kolik klíčů mohu mít?
Až tři aktivní klíče, například jeden pro každou integraci. Denní počet požadavků se počítá za celý účet, ne za jednotlivý klíč.
Jak zjistím ID stanice?
Každá stanice má číselné ID, které se nikdy nemění. ID své stanice najdete ve svém Profilu. Další stanice v okolí zadaného bodu i s jejich ID vrací endpoint /v1/stations/nearby.
Mohu volat API z JavaScriptu na webové stránce?
Přímo ne, protože by pak klíč mohl přečíst kdokoli, kdo stránku otevře. Volejte API ze svého serveru, ukládejte tam odpovědi a na stránku posílejte jen data.
Neverin Business

Potřebujete víc, než je v dokumentaci?

Prostřednictvím Neverin Business si můžete vyžádat výrazně více dat, než popisuje dokumentace API, včetně historie všech stanic a více stanic v jednom volání, a také vývoj systému na míru pro vaši firmu. Rozsah, limity a komerční použití se sjednávají smlouvou.

Kontaktujte nás