Vyvíjíme IHNED(.cz)
Vyvíjíme redakční technologie pro IHNED.cz

Volební API

October 14, 2013 / Redakční kodéři

Od začátku oddělení redakčního vývoje se snažíme vše, co vyprodukujeme, taky zveřejňovat pod otevřenou licencí. S blížícími se volbami programujeme kalkulačku průběžných výsledků, která vychází z dat zveřejňovaných ČSÚ na volby.cz. I tu najdete mezi našimi projekty - viz Volební moduly. Abyste ji však nemuseli zprovozňovat sami, spustíme před volbami veřejné API s již spočítanými výsledky. Konkrétní datum spuštění a finální endpointy včas oznámíme na našem twitteru, zatím pro vás máme specifikaci a ukázkové výstupy na základě dat z voleb 2010.

AKTUALIZOVÁNO:

API nabízí tři datasety - parties, candidates a country. Obsahují seznam stran a jejich výsledků, seznam již zvolených kandidátů a průběžné výsledky sčítání. Viz popis.

Co použitím našeho API získáte nad strojově čitelnými daty z Volby.cz? Především to je průběžný výpočet složení sněmovny včetně preferenčních hlasů, které ČSÚ zveřejní až po sečtení všech výsledků. Také máme k dispozici “mediální” server ČSÚ, který je oddělený od veřejného, takže i pokud volby.cz “spadnou”, naše API bude fungovat dál.

Výstup je ve formátu JSON. Počet požadavků na API nemá předem daná omezení, pokud nejste významný internetový portál, tak váš provoz naše technika ustojí. Budeme však monitorovat IP a HTTP referer, vyhrazujeme si právo v případě potřeby váš přístup omezit. Naše data také můžete předávat pomocí vlastní proxy, v takovém případě by neměl vůbec nastat problém, zvlášť pokud využijete HTTP If-Modified-Since, který budeme aktivně sledovat a odpovídat HTTP 304 Not Modified. V takovém případě nemáme problém ani s pollingem 1 request za sekundu.

Kategorie: Obecne