AI agent môže kúpiť galériu Framky
Framky Agent API pokrýva celý nákup — od fotografií zákazníka po zaplatenú objednávku. Platbu dokončí zákazník na stránke Stripe, agent sa teda nikdy nedotkne údajov o karte.
https://api.framky.com/api/agent/v1/openapi.yaml
Čo je to za produkt
Framky je nástenná fotogaléria: sada rámčekov z MDF s fotografiami zákazníka, vytlačenými a doručenými pripravenými na zavesenie. Rámčeky sú bez skla, takže nevznikajú odlesky, a montujú sa pomocou samolepiacich vešiakov — celá galéria visí na stene približne za 15 minút.
Čo agent dokáže
Založiť zákaznícky účet
Jediná požiadavka vráti token agenta. Ak je e-mail už zaregistrovaný, zákazník dostane 6-miestny kód, ktorým agenta autorizuje.
Nahrať fotografie
Multipart upload alebo zdrojová URL — fotografie sa uložia do knižnice zákazníka a použijú sa pre galériu.
Zostaviť galériu
Server naklonuje rozloženie produktu a automaticky priradí fotografie k rámčekom podľa rozlíšenia a pomeru strán, potom vykreslí vizuálny náhľad pre zákazníka.
Objednať a zaplatiť
Vytvorte objednávku, nastavte doručovaciu adresu a získajte platobný odkaz Stripe pre zákazníka.
Typický priebeh
- 1
Založte zákaznícky účet
POST /accounts - 2
Nahrajte fotografie zákazníka
POST /photos - 3
Prezrite si produkty a vyberte rozloženie
GET /products - 4
Vytvorte kompozíciu — server rozmiestni fotografie automaticky
POST /compositions - 5
Vykreslite náhľad a ukážte ho zákazníkovi
POST /compositions/{id}/preview - 6
V prípade potreby upravte kompozíciu ručne — API vracia odkaz na úpravy, kde zmeníte orez fotografie alebo ju vymeníte za inú
edit_url (from POST /compositions) - 7
Vytvorte objednávku a nastavte doručovaciu adresu
POST /orders + PUT /orders/{id}/shipping-address - 8
Získajte platobný odkaz Stripe a pošlite ho zákazníkovi
POST /orders/{id}/checkout - 9
Dopytujte sa na objednávku, kým nebude v stave „paid“
GET /orders/{id}
Schéma OpenAPI je jediný zdroj pravdy — nájdete v ňom všetky schémy požiadaviek aj odpovedí. Nasmerujte naň svoj agentný framework, GPT Action alebo MCP klienta.
Navrhnuté pre bezpečnú autonómiu
Zákazník platí na stránke hostovanej Stripe vo vlastnom prehliadači — API nikdy neprijíma údaje o karte od agenta.
Hlavička Idempotency-Key umožňuje každý POST bezpečne zopakovať: rovnaký kľúč počas 24 hodín vracia pôvodnú odpoveď.
Každá kompozícia vracia odkaz na úpravy, vďaka ktorému si zákazník galériu sám doladí v konfigurátore framky.com.