En AI-agent kan köpa ett Framky-galleri
Framky Agent API täcker hela köpet — från kundens foton till en betald beställning. Betalningen slutförs av kunden på en Stripe-sida, så agenten rör aldrig kortuppgifter.
https://api.framky.com/api/agent/v1/openapi.yaml
Vad produkten är
Framky är ett fotogalleri för väggen: ett set MDF-ramar med kundens foton, tryckta och levererade redo att hängas upp. Ramarna är utan glas, så det finns inga reflexer, och de monteras med självhäftande upphängare — hela galleriet sitter på väggen på cirka 15 minuter.
Vad en agent kan göra
Skapa ett kundkonto
En enda förfrågan returnerar en agent-token. Om e-postadressen redan är registrerad får kunden en 6-siffrig kod för att auktorisera agenten.
Ladda upp foton
Multipart-uppladdning eller en käll-URL — fotona hamnar i kundens bibliotek och används till galleriet.
Sätta ihop galleriet
Servern klonar en produktlayout och tilldelar automatiskt foton till ramar efter upplösning och bildförhållande, och renderar sedan en visuell förhandsvisning att visa kunden.
Beställa och betala
Lägg beställningen, ange leveransadressen och få en Stripe-betalningslänk till kunden.
Typiskt flöde
- 1
Skapa kundens konto
POST /accounts - 2
Ladda upp kundens foton
POST /photos - 3
Bläddra bland produkterna och välj en layout
GET /products - 4
Skapa en komposition — servern placerar fotona automatiskt
POST /compositions - 5
Rendera en förhandsvisning och visa den för kunden
POST /compositions/{id}/preview - 6
Justera kompositionen manuellt vid behov — API:et returnerar en redigeringslänk där du kan ändra ett fotos beskärning eller byta ut det mot ett annat
edit_url (from POST /compositions) - 7
Lägg beställningen och ange leveransadressen
POST /orders + PUT /orders/{id}/shipping-address - 8
Hämta Stripe-betalningslänken och skicka den till kunden
POST /orders/{id}/checkout - 9
Fråga beställningen tills statusen är ”paid”
GET /orders/{id}
OpenAPI-schemat är den enda källan till sanning — alla request- och response-scheman finns där. Rikta ditt agentramverk, din GPT Action eller din MCP-klient mot det.
Byggt för säker autonomi
Kunden betalar på en Stripe-värdbaserad sida i sin egen webbläsare — API:et tar aldrig emot kortuppgifter från en agent.
En Idempotency-Key-header gör varje POST säker att försöka igen: samma nyckel returnerar det ursprungliga svaret i 24 timmar.
Varje komposition returnerar en redigeringslänk som låter kunden själv finjustera galleriet i framky.com-konfiguratorn.