Content Feed API

Content Feed API poskytuje veřejný, neautentizovaný přístup k publikovaným článkům z Tokenizace.cz, filtrovaným podle témat (kategorií). API je určeno pro partnerské služby, které chtějí zobrazovat relevantní oborový obsah ve vlastním prostředí.

Typické použití: xixobox.com zobrazuje regulatorní novinky relevantní pro stablecoinové treasury, wideweb3.com zobrazuje články o compliance a přípravě na sandbox.

GET https://www.tokenizace.cz/api/content-feed

Parametry (query string):

topics — čárkou oddělené kategorie pro filtrování (např. stablecoiny,compliance,aml,bankovnictví). Bez tohoto parametru vrací všechny publikované články.

limit — maximální počet článků (1–20, výchozí 5).

lang — jazyk (cs/en/de/ru, výchozí cs). Ovlivňuje metadata odpovědi.

Odpověď obsahuje pole articles[] a objekt meta. Každý článek má: title, slug, category, excerpt (max 160 znaků), imageUrl, publishedAt (UNIX timestamp v ms), url (absolutní odkaz zpět na tokenizace.cz) a source (vždy "tokenizace.cz").

Meta objekt obsahuje: total (počet vrácených článků), topics (použité filtry), generatedAt (ISO timestamp), source a lang.

Pro rychlou integraci bez vlastního kódu je k dispozici embed stránka s hotovým widgetem:

https://www.tokenizace.cz/embed/knowledge?topics=stablecoiny,compliance&limit=5&theme=dark

Parametr theme přijímá hodnoty dark nebo light. Widget se přizpůsobí šířce kontejneru a zobrazí karty článků s titulkem, kategorií, datem a odkazem.

Integrace do HTML: <iframe src="https://www.tokenizace.cz/embed/knowledge?topics=stablecoiny,compliance&limit=5&theme=dark" width="100%" height="420" style="border:none;border-radius:12px" title="Regulace & standardy"></iframe>

API povoluje CORS požadavky z následujících domén: xixobox.com, wideweb3.com, tokenizace.cz a všechny *.macaly.dev / *.macaly.app subdomény.

Pro ostatní origin vrací Access-Control-Allow-Origin: * — API je veřejné a neobsahuje citlivá data.

const res = await fetch('https://www.tokenizace.cz/api/content-feed?topics=stablecoiny,compliance&limit=5');

const { articles } = await res.json();

articles.forEach(a => console.log(a.title, a.url));

API nemá explicitní rate limit, ale odpovědi jsou cachovány po dobu 5 minut (Cache-Control: public, s-maxage=300). Doporučujeme nepřekračovat 60 požadavků za minutu.