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 — požadovaný jazyk (cs/en/de/ru, výchozí cs). Titulek a excerpt jsou přeložené pouze při dostupném úplném překladu článku; jinak položka výslovně používá český originál. Neznámý jazyk nebo neplatný limit vrací HTTP 400.

Odpověď obsahuje pole articles[] a objekt meta. Položka článku má title, slug, category, excerpt (max 160 znaků), imageUrl, publishedAt (UNIX timestamp v ms), url a source ("tokenizace.cz"). contentLanguage určuje skutečný jazyk textu a translationAvailable dostupnost úplného překladu. imageLanguage je cs, dokud není dostupná schválená lokalizovaná mediální sada; samotná volba lang nepřekládá text uvnitř obrázku. Odkaz vede na /<slug> pro češtinu nebo /<lang>/<slug> pro jiný jazyk.

Meta objekt obsahuje total (počet vrácených článků), topics (použité filtry), generatedAt (ISO timestamp), source a lang. Meta.lang označuje požadovaný jazyk, nikoli záruku překladu každé položky; ověřte contentLanguage a translationAvailable u každého článku.

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>

Content Feed je veřejné neautentizované GET API pro publikovaný redakční obsah. CORS umožňuje čtení z libovolného webového originu (Access-Control-Allow-Origin: *); přístup není omezen seznamem domén Macaly nebo partnerů.

CORS není autentizace ani oprávnění k neveřejným datům. Endpoint neslouží k přenosu přihlašovacích údajů a neposkytuje neveřejné profily, administraci ani uživatelská 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.