Zprávy, zdroje a opravy přes API
Jedno české a jedno slovenské vydání. Stabilní identifikátory, dohledatelné zdroje a změny, které může sledovat člověk i AI asistent.
Veřejný odběr je navržen bez účtu a API klíče přes stejné HTTPS jako web. Tato příručka sama nepotvrzuje otevření veřejného portálu; dostupnost ověřujte skutečnou odpovědí rozhraní.
Základ tohoto vydání: https://novinky.nakupovani.cz. Samostatný port ani MCP server nejsou potřeba. Rozhraní přijímá GET a HEAD; HEAD nevrací tělo. Parametry posílejte vždy jen jednou a hodnoty kódujte jako URL.
Najít článek a načíst jeho text
GET /api/v1/articles — limit 1–50 (výchozí 24), topic, category, q, cursor. Hledání q prochází titulek, souhrn a odstavce bez rozlišení velikosti písmen. Okrajové mezery se odstraní, souvislé mezery sjednotí; nejvýše 160 znaků po normalizaci. Znaky %, _ a zpětné lomítko jsou doslovné.
Rubriky topic: home, world, money, science, technology, health, family, motoring, culture, lifestyle, travel, sport, environment.
Podrobné rubriky category: home, world, economy-business, money-work, science-research, technology-ai, space, health-medicine, nature-animals, climate-energy, motoring-transport, travel, homes-architecture, garden-home, food-cooking, family-relationships, culture-art, history, sport-exercise, games-entertainment, education, fashion-beauty, luxury-design, interesting.
https://novinky.nakupovani.cz/api/v1/articles?limit=3&topic=science
Otevřít tři vědecké články · Příklad hledání: vesmír
Odpověď obsahuje edition, items a nextCursor. Seznam vrací přehled, nikoli paragraphs a assets. Pro úplný text použijte ID z items: GET /api/v1/articles/{uuid}. nextCursor je neprůhledný: nevytvářejte jej sami, vraťte jej nezměněný se stejným vydáním, rubrikou a normalizovaným hledáním. Kurzor náhledu nepatří do veřejného odběru. Hodnota nextCursor=null znamená, že další stránka není dostupná.
Angličtina je překlad existujícího článku
GET /api/v1/articles/{uuid}?language=en. Použijte ID dostupného českého nebo slovenského originálu. Hotový překlad vrací 200 a language=en; odkazuje na translationOf a sourceVersion. Není to třetí samostatný kanál.
Pokud originál existuje, ale překlad není připravený, první GET může zařadit jeho přípravu. Odpověď 202 obsahuje status=pending a Retry-After: 30. Respektujte aktuální hlavičku a zkuste později; 202 nikdy neukládejte ani nevydávejte jako článek. HEAD přípravu překladu nezařazuje. Oprava originálu zneplatní starší překlad.
Sledovat změny a stažení
GET /api/v1/changes?cursor=0&limit=50. limit je 1–50, výchozí 50. Začněte textovým kurzorem 0 a po zpracování odpovědi uložte nextCursor pro stejné vydání. Události obsahují articleId, version, kind a at, ne text článku. Sledujte published, corrected, updated, translation_ready a disabled. Otevřít změnový kanál.
Identitu ukládejte jako edition + id; konkrétní obsah rozlišujte také version a language. Novější verze nahrazuje starší text. Při disabled stáhněte dříve převzatý text i překlad z dalšího poskytování. Vypnutý článek zmizí ze seznamu a feedů, detail vrací 404; obsahově prázdná událost stažení ve změnovém kanálu zůstává.
Historie oprav jednoho článku
GET /api/v1/articles/{uuid}/corrections?after_version=0&limit=50. after_version je celé číslo od 0, limit 1–50, výchozí 50. Odpověď obsahuje articleId, sourceVersion, corrections a nextVersion; pokud nextVersion není null, použijte jej jako další after_version. Každý záznam uvádí fromVersion, toVersion, kind, summary a at.
Samotný detail článku obsahuje jen posledních 20 oprav (correctionsWindow=latest20). Úplnou dostupnou historii proto stránkujte přes tuto cestu. Historie není dostupná pro vypnutý nebo nepřístupný článek.
Předpověď pro města
Mapa českých krajských měst · GET /api/v1/weather. Bez parametrů. Odpověď obsahuje edition, generatedAt, kind=forecast a cities. Každé město má souřadnice, temperatureC, state, validAt, časy původu dat, sourceURL a rights. Nejde o měření ani průměr kraje. unavailable není nula stupňů; starší údaj má state=stale. Zachovejte zdroj, licenci a platnost.
RSS a JSON Feed
GET /rss.xml — RSS 2.0. GET /feed.json — JSON Feed 1.1. Oba poskytují nejvýše posledních 24 článků bez parametrů hledání či stránkování; nejsou úplný archiv. JSON Feed uchovává verzi, zdroje a obrazové kredity v rozšíření _news. Pro spolehlivou synchronizaci a stažení používejte také změnový kanál.
Zdroj není automaticky licence k převzetí
Zachovejte URL článku, vydání, verzi, datum, zdroje a konkrétní atribuci. sources odkazují na podklady; jejich uvedení nepřenáší cizí práva automaticky na odběratele. Tato příručka neuděluje plošnou licenci k našemu vlastnímu textu. Další převzetí a šíření se řídí konkrétním oprávněním a podmínkami uvedenými u daného obsahu.
Obrázky posuzujte zvlášť: image a assets mohou mít jiné podmínky než text. Zachovejte credit, sourceURL, license, licenseProofURL a redistribution, pokud jsou uvedeny; chybějící či unknown oprávnění není souhlas. Povolení zobrazit obrázek na našem webu samo nepovoluje jeho další šíření. AI tematickou ilustraci nevydávejte za fotografický důkaz události a ponechte její označení.
Před použitím vždy zkontrolujte HTTP stav a očekávanou strukturu JSON. Chybové odpovědi 400, 404 nebo 503 ani 202 pending nejsou články. Nepovažujte za nový obsah prázdnou odpověď HEAD, chybu načtení nebo starou verzi v místní paměti.
Přejít k přehledu článků · Nezávislost a zdroje · Zpět ke zprávám