Průvodce nasazením

Váš projekt → váš hosting

API je určené pro Codex, Claude Code a další nástroje schopné odesílat HTTP požadavky. V ChatGPT závisí přímé nahrání na dostupných nástrojích. Univerzální MCP konektor v této verzi není k dispozici. Ručně můžete nahrát ZIP v klientském účtu.

1. Připravte statický export

ZIP musí obsahovat index.html přímo v hlavní složce, CSS, JavaScript a ostatní veřejné soubory. Nevkládejte .env, hesla, node_modules, zdrojové PHP, spustitelné programy nebo další archivy. ZIP může mít 50 MiB, nejvýše 2 000 souborů a rozbalená verze 200 MB.

2. Vytvořte přístupový klíč

Po uhrazení a aktivaci služby otevřete Propojení s AI. Vyberte oprávnění. Klíč platí 90 dní a lze jej kdykoli zrušit. Uložte jej jako tajnou proměnnou AI_HOSTING_KEY v prostředí asistenta. Nevkládejte jej do veřejného JavaScriptu, chatu ani GitHubu.

3. Nahrajte a zveřejněte verzi

curl --fail-with-body https://ai-hosting.cz/api/v1/site \
  -H "Authorization: Bearer $AI_HOSTING_KEY"

curl --fail-with-body https://ai-hosting.cz/api/v1/releases \
  -H "Authorization: Bearer $AI_HOSTING_KEY" \
  -H "Accept: application/json" -F archive=@web.zip

# Do release vložte UUID vrácené předchozím požadavkem.
curl --fail-with-body https://ai-hosting.cz/api/v1/publish \
  -H "Authorization: Bearer $AI_HOSTING_KEY" \
  -H "Content-Type: application/json" \
  -d '{"release":"UUID_NAHRANE_VERZE"}'

Nahrání potřebuje oprávnění files.write. Neúspěšná bezpečnostní kontrola nasazení zastaví. Aktuální verze zůstane beze změny. Do kapacity se počítají všechny uchované verze a databáze. Uchovávají se nejvýše tři verze.

4. Databáze

Každý web má vlastní SQLite soubor. API slouží k administraci databáze. Pro veřejný formulář potřebujete zvláštní zabezpečený backend; správní klíč nesmí být v prohlížeči návštěvníka. PHP, MySQL ani obecné serverové procesy v této verzi nejsou spuštěné.

POST /api/v1/database
Authorization: Bearer …

POST /api/v1/database/query
Content-Type: application/json
Authorization: Bearer …

{"sql":"SELECT name FROM sqlite_master LIMIT 100","write":false}

Vytvoření a změna databáze vyžaduje database.write, čtení database.read. Dotazy mají limit 2 sekundy, 500 řádků a 1 MB výsledku. Soubor databáze má limit 100 MB. Čtení jiných souborů, připojení dalších databází a rozšíření nejsou povolené.

5. Doména

V klientském účtu uložte vlastní doménu, nastavte zobrazený A a ověřovací TXT záznam. Po ověření je třeba vystavit HTTPS certifikát. Nákup a prodloužení domén přes Subreg připravujeme.

Otevřít klientský účet