AI agent může koupit galerii Framky
Framky Agent API pokrývá celý nákup — od fotografií zákazníka po zaplacenou objednávku. Platbu dokončí zákazník na stránce Stripe, agent se tedy nikdy nedotkne údajů o kartě.
https://api.framky.com/api/agent/v1/openapi.yaml
Co je to za produkt
Framky je nástěnná fotogalerie: sada rámů z MDF s fotografiemi zákazníka, vytištěnými a doručenými připravenými k zavěšení. Rámy jsou bez skla, takže nevznikají odlesky, a montují se pomocí samolepicích věšáků — celá galerie visí na stěně zhruba za 15 minut.
Co agent dokáže
Založit zákaznický účet
Jediný požadavek vrátí token agenta. Pokud je e-mail už zaregistrovaný, zákazník dostane 6místný kód, kterým agenta autorizuje.
Nahrát fotografie
Multipart upload nebo zdrojová URL — fotografie se uloží do knihovny zákazníka a použijí se pro galerii.
Sestavit galerii
Server naklonuje rozložení produktu a automaticky přiřadí fotografie k rámům podle rozlišení a poměru stran, poté vykreslí vizuální náhled pro zákazníka.
Objednat a zaplatit
Vytvořte objednávku, nastavte doručovací adresu a získejte platební odkaz Stripe pro zákazníka.
Typický průběh
- 1
Založte zákaznický účet
POST /accounts - 2
Nahrajte fotografie zákazníka
POST /photos - 3
Projděte produkty a vyberte rozložení
GET /products - 4
Vytvořte kompozici — server rozmístí fotografie automaticky
POST /compositions - 5
Vykreslete náhled a ukažte ho zákazníkovi
POST /compositions/{id}/preview - 6
V případě potřeby upravte kompozici ručně — API vrací odkaz pro úpravy, kde změníte ořez fotografie nebo ji vyměníte za jinou
edit_url (from POST /compositions) - 7
Vytvořte objednávku a nastavte doručovací adresu
POST /orders + PUT /orders/{id}/shipping-address - 8
Získejte platební odkaz Stripe a pošlete ho zákazníkovi
POST /orders/{id}/checkout - 9
Dotazujte se na objednávku, dokud nebude ve stavu „paid“
GET /orders/{id}
Schéma OpenAPI je jediný zdroj pravdy — najdete v něm všechna schémata požadavků i odpovědí. Nasměrujte na něj svůj agentní framework, GPT Action nebo MCP klienta.
Navrženo pro bezpečnou autonomii
Zákazník platí na stránce hostované Stripe ve vlastním prohlížeči — API nikdy nepřijímá údaje o kartě od agenta.
Hlavička Idempotency-Key umožňuje každý POST bezpečně opakovat: stejný klíč po dobu 24 hodin vrací původní odpověď.
Každá kompozice vrací odkaz pro úpravy, díky němuž si zákazník galerii sám doladí v konfigurátoru framky.com.