Objednání hostingu pomocí AI agenta

Agent může zjistit parametry, připravit objednávku a sledovat aktivaci. S výslovným oprávněním pak získá přístup k nahrávání a databázi konkrétního zaplaceného webu.

Klient potvrzuje konkrétní objednávku a její cenu. Může zaplatit sám, nebo ve Fakturaci udělit samostatné platební pověření a uložit kartu ve Stripe. Agent pak smí zahájit právě toto předplatné. Banka může vyžádat dodatečné ověření klientem. MCP konektor tato verze neposkytuje. Dostupnost běžných a agentních plateb ověřte v ceníku API.
  1. Klient se přihlásí a v Agentním objednávání vytvoří omezené pověření. Klíč uloží do úložiště tajných údajů HTTP nástroje.
  2. Agent načte ceník a limity, připraví statický export a založí návrh s očekávanou cenou.
  3. Klient otevře vrácený odkaz, přihlásí se do svého účtu, zkontroluje údaje a potvrdí objednávku. Adresa se rezervuje až tímto potvrzením. Návrh platí nejvýše 7 dní.
  4. Platba proběhne přes Stripe. Pro platbu agentem klient ve Fakturaci potvrdí platební pověření a uloží kartu; agent zavolá POST /api/agent/v1/orders/{id}/pay s JSON {}. Stejný endpoint lze bezpečně zopakovat pro stejnou objednávku. Stav requires_customer_action znamená, že klient musí otevřít customer_action_url a dokončit platbu. Údaje karty ani souhlas klienta se neposílají do agentního API.
  5. Agent sleduje stav nejvýše jednou za 30 sekund. Po aktivaci může při povolené správě získat klíč pro daný web, nahrát ZIP a zveřejnit jej přes API pro správu.

OpenAPI 3.1 specifikace · Pokyny pro AI nástroje

Příklad požadavku

Částky jsou v haléřích. Pro 1 GB očekáváte 36500, pro 2 GB 66500. Používejte cenu z aktuálního ceníku. Klíč níže představuje proměnnou prostředí, nikoli skutečné přístupové údaje.

curl https://ai-hosting.cz/api/agent/v1/orders \
  -H "Authorization: Bearer $AI_HOSTING_ORDER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-order-request-0001" \
  -d '{"subdomain":"moje-prezentace","capacity_gb":1,"expected_annual_minor":36500}'

Při nejistém výsledku opakujte stejný požadavek se stejným Idempotency-Key. Změněný obsah se stejným klíčem vrátí 409. Platný klíč vrací existující návrh i po vyčerpání limitu; změna ceny nevytvoří dražší objednávku automaticky.

Přístup ke správě

POST /api/agent/v1/orders/{id}/deployment-key vrátí po aktivaci klíč ahk_ pro API /api/v1. Každé zavolání nahradí předchozí klíč vydaný pro tuto objednávku. Klíč platí nejdéle do konce pověření, jeho zrušení odvolá i tento přístup. Objednávkový klíč aho_ nelze použít k nahrávání a běžný klíč webu nelze použít k objednávání.

API nevytváří účty bez ověření e-mailu. Návrh před potvrzením klientem se neodesílá do Systému. Potvrzená objednávka používá stejnou evidenci a fakturaci jako běžná objednávka; doklad vzniká až k zaplacené platbě.