Princip a 3 pravidla

Jak to funguje

Tvůj web (Astro)               Contenta API (api.contenta.cz)            Admin
  build:   GET  /public/...   --X-Site-Key-->   veřejné READ API     ← klient řídí obsah
  runtime: POST komentáře/formuláře --X-Site-Key-->
                          <-- POST na build hook --   rebuild po publikaci
  (iframe v adminu) <-- postMessage --> ŽIVÝ NÁHLED (markery data-cn)

Tři univerzální pravidla

Jeden kontrakt. Vše přes https://api.contenta.cz/api/v1/public/sites/<slug>/… s hlavičkou X-Site-Key: <apiKey>. Odpověď je { data } (u seznamů { data, meta: { nextCursor, hasMore } }).
Dva typy modulů:
- Build-time (obsah se zapeče do statiky při buildu) → po publikaci v adminu se web musí přebudovat (build hook).
- Runtime (klientský JS v prohlížeči, bez rebuildu) → potřebuje PUBLIC_* proměnné.
Routy webu MUSÍ sedět na urlPaths webu — jinak odkazy z API i živý náhled nesedí.

Výchozí URL cesty (`urlPaths`)

Kind	Výchozí cesta	Kind	Výchozí cesta
posts (blog)	`/blog/{slug}/`	categories	`/{slug}/` (top-level)
glossary	`/slovnik/{slug}/`	pages	`/{slug}/` (top-level)
authors	`/autor/{slug}/`	jobs	`/kariera/{slug}/`

Build-time vs runtime

Modul	Typ	Rebuild po publikaci?
Menu, Homepage, Stránky, Blog, Rubriky, Autoři, Slovník, Kariéra, Přesměrování, Galerie	build-time	Ano (build hook)
Komentáře, Formuláře, Vyhledávání	runtime (client JS + `PUBLIC_*`)	Ne
Návštěvnost	tracker v `<head>`	Ne

Princip a 3 pravidla

Jak to funguje

Tři univerzální pravidla

Výchozí URL cesty (urlPaths)

Build-time vs runtime

Výchozí URL cesty (`urlPaths`)