Napojení existujícího webu

Máš web, který už běží na ostré doméně, repo i Cloudflare účet jsou jinde? Napojení funguje napříč účty i stroji — vše jede přes HTTPS API a jednu webhook URL. Žádné sdílení účtu není potřeba.

Dvě strany

• STRANA A — Správce Contenta (admin): založí/upraví web, vygeneruje klíč, vloží build hook.
• STRANA B — Vlastník webu (repo + CF účet): přidá integrační kód, nastaví proměnné, vytvoří deploy hook.

Pokud jsi obě strany, provedeš oba sloupce sám.

Co si strany předají

Hodnota	Směr	Co to je
CONTENTA_API_URL	A → B	https://api.contenta.cz/api/v1
X-Site-Key (apiKey)	A → B	per-web read/form klíč (rk_…)
SITE_SLUG	A → B	slug webu v Contentě
Deploy hook URL	B → A	URL z CF Pages, na kterou Contenta pingne rebuild

Na co u existujícího webu pozor

• Nesmí se rozbít — integruj přírůstkově a s graceful fallbackem. Migruj modul po modulu; nevyplněná pole nech na napevném obsahu.
• Žádné auto-provisioning — CF Pages i doména už existují (jsou STRANY B). Contenta nic neprovisionuje; primaryDomain je jen metadata (pro náhled a stavbu veřejných URL).
• Build hook přes účty funguje — Contenta jen pošle POST na CF deploy-hook URL; na účtu nezáleží. HMAC secret má smysl jen u vlastního CI (detail).
• Živý náhled funguje cross-origin — admin (contenta.cz) načte tvou ostrou doménu v iframu; postMessage projde i přes různé domény (origin check v PreviewBridge povoluje *.contenta.cz).

Postup v kostce

1. A: založ/uprav web (primaryDomain = ostrá doména, profil/tarif), ulož apiKey.
2. A → B: předej API URL + apiKey + slug.
3. B: přidej API klienta + render, nastav env v CF Pages, vytvoř deploy hook, pošli URL zpět.
4. A: vlož deploy hook do buildWebhookUrl.
5. Test: publikuj obsah → web se přebuduje → obsah naskočí.