Een AI-agent kan een Framky-galerij kopen
De Framky Agent API dekt de hele aankoop — van de foto's van de klant tot een betaalde bestelling. De betaling rondt de klant af op een Stripe-pagina, dus de agent raakt nooit kaartgegevens aan.
https://api.framky.com/api/agent/v1/openapi.yaml
Wat het product is
Framky is een fotogalerij voor de muur: een set MDF-lijsten met de foto's van de klant, gedrukt en kant-en-klaar geleverd om op te hangen. De lijsten zijn zonder glas, dus geen reflecties, en worden gemonteerd met zelfklevende ophangers — de hele galerij hangt in ongeveer 15 minuten aan de muur.
Wat een agent kan doen
Een klantaccount aanmaken
Eén verzoek levert een agent-token op. Is het e-mailadres al geregistreerd, dan ontvangt de klant een 6-cijferige code om de agent te autoriseren.
Foto's uploaden
Multipart-upload of een bron-URL — de foto's komen in de bibliotheek van de klant en worden voor de galerij gebruikt.
De galerij samenstellen
De server kloont de lay-out van een product en wijst foto's automatisch toe aan lijsten op basis van resolutie en beeldverhouding, en rendert daarna een visuele preview om aan de klant te tonen.
Bestellen en betalen
Plaats de bestelling, stel het bezorgadres in en ontvang een Stripe-betaallink voor de klant.
Typische flow
- 1
Maak het klantaccount aan
POST /accounts - 2
Upload de foto's van de klant
POST /photos - 3
Bekijk de producten en kies een lay-out
GET /products - 4
Maak een compositie — de server plaatst de foto's automatisch
POST /compositions - 5
Render een preview en laat die aan de klant zien
POST /compositions/{id}/preview - 6
Pas de compositie zo nodig handmatig aan — de API geeft een bewerkingslink waar je de uitsnede van een foto kunt wijzigen of een foto kunt vervangen
edit_url (from POST /compositions) - 7
Plaats de bestelling en stel het bezorgadres in
POST /orders + PUT /orders/{id}/shipping-address - 8
Haal de Stripe-betaallink op en stuur die naar de klant
POST /orders/{id}/checkout - 9
Vraag de bestelling op totdat de status 'paid' is
GET /orders/{id}
Het OpenAPI-schema is de enige bron van waarheid — alle request- en responseschema's staan daar. Richt je agent-framework, GPT Action of MCP-client erop.
Ontworpen voor veilige autonomie
De klant betaalt op een door Stripe gehoste pagina in de eigen browser — de API accepteert nooit kaartgegevens van een agent.
Een Idempotency-Key-header maakt elke POST veilig om opnieuw te proberen: dezelfde sleutel geeft 24 uur lang het oorspronkelijke antwoord terug.
Elke compositie levert een bewerkingslink waarmee de klant de galerij zelf verfijnt in de framky.com-configurator.