Tarif Agency

Vlastní stránka přes API

Značkovou download stránku obvykle sestavíte klikáním v aplikaci. Přes API to samé zvládne váš program nebo AI agent — stránku vytvoří a rovnou ji publikuje pod váš odkaz. Bez ručního nastavování.

K čemu to je

Každý nahraný soubor má svůj odkaz ke stažení. Přes API k němu připojíte vlastní stránku — návštěvník ji uvidí přes celou plochu místo neutrální stránky, než si soubor stáhne. Hodí se, když chcete stránky vytvářet automaticky nebo je nechat postavit AI agenta. O bezpečné a spolehlivé zobrazení se postaráme my; vy dodáte jen obsah stránky.

Než začnete

  1. Tarif Agency. API je jeho součástí.
  2. API klíč. Vygenerujete si ho níže. Přiložíte ho ke každému požadavku — klíč zastupuje přihlášení, žádné heslo se nikam neposílá.
  3. ID souboru. Nahrajte soubor a otevřete jeho detail; ID najdete v adrese: …/files/ID.

API klíč je součástí tarifu Agency. Po jeho aktivaci si ho tady vygenerujete jedním kliknutím.

Získat Agency

Volání API

Pošlete jeden POST požadavek. Klíč přiložíte v hlavičce Authorization.

POST https://souborovna.cz/api/campaign/custom-html

Hlavičky

  • Authorization: Bearer <váš klíč>
  • Content-Type: application/json

Tělo požadavku (JSON)

PoleTypPopis
fileIdstringID souboru, ke kterému stránku připojujete. Povinné.
htmlstringKompletní HTML stránky. Max 1 MB.
publishbooleantrue stránku rovnou zveřejní. Vynecháte-li, uloží se jako rozpracovaná.

Příklad

curl -X POST https://souborovna.cz/api/campaign/custom-html \
  -H "Authorization: Bearer sbrvn_váš_klíč" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "cmr661cza0000e8hkkgx8wgrw",
    "html": "<!doctype html><html><body>Ahoj!</body></html>",
    "publish": true
  }'

Odpověď

{
  "ok": true,
  "slug": "s6nkd6n3vdjhpykf",
  "url": "/f/s6nkd6n3vdjhpykf",
  "published": true
}

url je hotová adresa stránky — rovnou ji můžete sdílet.

Pro AI agenty

Agent (třeba v Claude Code) vygeneruje HTML na míru obsahu souboru a jedním voláním ho publikuje. Zákazník nemusí psát kód ani vkládat stránku ručně — odkaz je hned živý.

Strojově čitelná verze této dokumentace: souborovna.cz/api-docs.txt — tento odkaz pošlete svému agentovi, ať si API přečte.

Získat tarif AgencyMáte dotaz? Napište nám