Správy, zdroje a opravy cez API
Jedno slovenské a jedno české vydanie. Stabilné identifikátory, dohľadateľné zdroje a zmeny, ktoré môže sledovať človek aj AI asistent.
Verejný odber je navrhnutý bez účtu a API kľúča cez rovnaké HTTPS ako web. Táto príručka sama nepotvrdzuje otvorenie verejného portálu; dostupnosť overujte skutočnou odpoveďou rozhrania.
Základ tohto vydania: https://novinky.nakupovanie.sk. Samostatný port ani MCP server nie sú potrebné. Rozhranie prijíma GET a HEAD; HEAD nevracia telo. Parametre posielajte vždy iba raz a hodnoty kódujte ako URL.
Nájsť článok a načítať jeho text
GET /api/v1/articles — limit 1–50 (predvolený 24), topic, category, q, cursor. Hľadanie q prechádza titulok, súhrn a odseky bez rozlišovania veľkosti písmen. Okrajové medzery sa odstránia, súvislé medzery zjednotia; najviac 160 znakov po normalizácii. Znaky %, _ a spätná lomka sú 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.nakupovanie.sk/api/v1/articles?limit=3&topic=science
Otvoriť tri vedecké články · Príklad hľadania: vesmír
Odpoveď obsahuje edition, items a nextCursor. Zoznam vracia prehľad, nie paragraphs a assets. Pre úplný text použite ID z items: GET /api/v1/articles/{uuid}. nextCursor je nepriehľadný: neskladajte ho sami, vráťte ho nezmenený s rovnakým vydaním, rubrikou a normalizovaným hľadaním. Kurzor náhľadu nepatrí do verejného odberu. Hodnota nextCursor=null znamená, že ďalšia strana nie je dostupná.
Angličtina je preklad existujúceho článku
GET /api/v1/articles/{uuid}?language=en. Použite ID dostupného českého alebo slovenského originálu. Hotový preklad vracia 200 a language=en; odkazuje na translationOf a sourceVersion. Nie je to tretí samostatný kanál.
Ak originál existuje, ale preklad nie je pripravený, prvý GET môže zaradiť jeho prípravu. Odpoveď 202 obsahuje status=pending a Retry-After: 30. Rešpektujte aktuálnu hlavičku a skúste neskôr; 202 nikdy neukladajte ani nevydávajte ako článok. HEAD prípravu prekladu nezaraďuje. Oprava originálu zneplatní starší preklad.
Sledovať zmeny a stiahnutia
GET /api/v1/changes?cursor=0&limit=50. limit je 1–50, predvolený 50. Začnite textovým kurzorom 0 a po spracovaní odpovede uložte nextCursor pre rovnaké vydanie. Udalosti obsahujú articleId, version, kind a at, nie text článku. Sledujte published, corrected, updated, translation_ready a disabled. Otvoriť zmenový kanál.
Identitu ukladajte ako edition + id; konkrétny obsah rozlišujte aj version a language. Novšia verzia nahrádza starší text. Pri disabled stiahnite skôr prevzatý text aj preklad z ďalšieho poskytovania. Vypnutý článok zmizne zo zoznamu a feedov, detail vracia 404; obsahovo prázdna udalosť stiahnutia v zmenovom kanáli zostáva.
História opráv jedného článku
GET /api/v1/articles/{uuid}/corrections?after_version=0&limit=50. after_version je celé číslo od 0, limit 1–50, predvolený 50. Odpoveď obsahuje articleId, sourceVersion, corrections a nextVersion; ak nextVersion nie je null, použite ho ako ďalší after_version. Každý záznam uvádza fromVersion, toVersion, kind, summary a at.
Samotný detail článku obsahuje iba posledných 20 opráv (correctionsWindow=latest20). Úplnú dostupnú históriu preto stránkujte cez túto cestu. História nie je dostupná pre vypnutý alebo neprístupný článok.
Predpoveď pre mestá
Mapa slovenských krajských miest · GET /api/v1/weather. Bez parametrov. Odpoveď obsahuje edition, generatedAt, kind=forecast a cities. Každé mesto má súradnice, temperatureC, state, validAt, časy pôvodu dát, sourceURL a rights. Nejde o meranie ani priemer kraja. unavailable nie je nula stupňov; starší údaj má state=stale. Zachovajte zdroj, licenciu a platnosť.
RSS a JSON Feed
GET /rss.xml — RSS 2.0. GET /feed.json — JSON Feed 1.1. Oba poskytujú najviac posledných 24 článkov bez parametrov hľadania či stránkovania; nie sú úplný archív. JSON Feed uchováva verziu, zdroje a obrazové kredity v rozšírení _news. Pre spoľahlivú synchronizáciu a stiahnutia používajte aj zmenový kanál.
Zdroj nie je automaticky licencia na prevzatie
Zachovajte URL článku, vydanie, verziu, dátum, zdroje a konkrétnu atribúciu. sources odkazujú na podklady; ich uvedenie neprenáša cudzie práva automaticky na odberateľa. Táto príručka neudeľuje plošnú licenciu k nášmu vlastnému textu. Ďalšie prevzatie a šírenie sa riadi konkrétnym oprávnením a podmienkami uvedenými pri danom obsahu.
Obrázky posudzujte osobitne: image a assets môžu mať iné podmienky ako text. Zachovajte credit, sourceURL, license, licenseProofURL a redistribution, ak sú uvedené; chýbajúce či unknown oprávnenie nie je súhlas. Povolenie zobraziť obrázok na našom webe samo nepovoľuje jeho ďalšie šírenie. AI tematickú ilustráciu nevydávajte za fotografický dôkaz udalosti a ponechajte jej označenie.
Pred použitím vždy skontrolujte HTTP stav a očakávanú štruktúru JSON. Chybové odpovede 400, 404 alebo 503 ani 202 pending nie sú články. Nepovažujte za nový obsah prázdnu odpoveď HEAD, chybu načítania alebo starú verziu v miestnej pamäti.
Prejsť k prehľadu článkov · Nezávislosť a zdroje · Späť k správam