En AI-agent kan købe et Framky-galleri
Framky Agent API dækker hele købet — fra kundens fotos til en betalt ordre. Betalingen gennemføres af kunden på en Stripe-side, så agenten rører aldrig kortdata.
https://api.framky.com/api/agent/v1/openapi.yaml
Hvad produktet er
Framky er et fotogalleri til væggen: et sæt MDF-rammer med kundens fotos, trykt og leveret klar til ophængning. Rammerne er uden glas, så der er ingen refleksioner, og de monteres med selvklæbende ophæng — hele galleriet hænger på væggen på cirka 15 minutter.
Hvad en agent kan
Oprette en kundekonto
Én forespørgsel returnerer et agent-token. Er e-mailen allerede registreret, modtager kunden en 6-cifret kode til at autorisere agenten.
Uploade fotos
Multipart-upload eller en kilde-URL — fotoene lander i kundens bibliotek og bruges til galleriet.
Sammensætte galleriet
Serveren kloner et produktlayout og tildeler automatisk fotos til rammer efter opløsning og billedformat, og renderer derefter en visuel forhåndsvisning til kunden.
Bestille og betale
Afgiv ordren, angiv leveringsadressen, og modtag et Stripe-betalingslink til kunden.
Typisk forløb
- 1
Opret kundens konto
POST /accounts - 2
Upload kundens fotos
POST /photos - 3
Gennemse produkterne og vælg et layout
GET /products - 4
Opret en komposition — serveren placerer fotoene automatisk
POST /compositions - 5
Render en forhåndsvisning og vis den til kunden
POST /compositions/{id}/preview - 6
Juster om nødvendigt kompositionen manuelt — API'et returnerer et redigeringslink, hvor du kan ændre et fotos beskæring eller udskifte det med et andet
edit_url (from POST /compositions) - 7
Afgiv ordren og angiv leveringsadressen
POST /orders + PUT /orders/{id}/shipping-address - 8
Hent Stripe-betalingslinket og send det til kunden
POST /orders/{id}/checkout - 9
Forespørg på ordren, indtil status er ”paid”
GET /orders/{id}
OpenAPI-skemaet er den eneste sandhedskilde — alle request- og response-skemaer ligger dér. Peg dit agent-framework, din GPT Action eller din MCP-klient på det.
Designet til sikker autonomi
Kunden betaler på en Stripe-hostet side i sin egen browser — API'et modtager aldrig kortdata fra en agent.
En Idempotency-Key-header gør hver POST sikker at gentage: den samme nøgle returnerer det oprindelige svar i 24 timer.
Hver komposition returnerer et redigeringslink, som lader kunden selv finpudse galleriet i framky.com-konfiguratoren.