# Souborovna API — postav a publikuj stránku pod download odkazem Uživatel má tarif Agency a vygeneroval API klíč u konkrétní stránky. Klíč je vázaný na tu stránku, takže NEPOTŘEBUJEŠ žádné fileId — stačí klíč a HTML. ## Co máš udělat (agent), krok za krokem 1. Vytvoř kompletní samostatné HTML jedné stránky podle zadání uživatele. - Vše inline: CSS i JS uvnitř HTML. - Obrázky jako data URI nebo absolutní https URL (žádné lokální cesty). - Nepřidávej tlačítko ke stažení souboru — to doplní Souborovna sama. - Maximálně 1 MB. 2. Odešli HTML jedním POST požadavkem (viz níže). 3. Z odpovědi vrať uživateli hodnotu "url" — to je hotová veřejná adresa stránky. ## Volání POST https://souborovna.cz/api/campaign/custom-html Hlavičky: Authorization: Bearer Content-Type: application/json Tělo (JSON): { "html": "", "publish": true } fileId neuváděj — klíč vázaný na stránku ho zná sám. (Jen obecný, nevázaný klíč fileId vyžaduje: přidej do těla "fileId": "".) ## Příklad (curl) curl -X POST https://souborovna.cz/api/campaign/custom-html \ -H "Authorization: Bearer sbrvn_vas_klic" \ -H "Content-Type: application/json" \ -d '{"html":"Ahoj","publish":true}' ## Odpověď (200) { "ok": true, "slug": "s6nkd6n3vdjhpykf", "url": "/f/s6nkd6n3vdjhpykf", "published": true } ## Chybové stavy - 401 — neplatný nebo chybějící API klíč. - 403 — účet nemá tarif Agency. - 400 — chybí fileId (jen u obecného klíče) — přidej "fileId". - 404 — soubor nenalezen. ## Dobré vědět - Stránka běží v bezpečném sandboxu; stažení souboru řeší plovoucí lístek Souborovny a je vždy navrchu (do HTML ho nepřidávej). - publish:true stránku rovnou zveřejní; bez něj se uloží jako koncept. - Když je stránka nastavená a publikovaná, má přednost před šablonovým vzhledem.