AI agent može kupiti Framky galeriju
Framky Agent API pokriva cijelu kupnju — od kupčevih fotografija do plaćene narudžbe. Plaćanje dovršava kupac na Stripe stranici, pa agent nikada ne dira podatke o kartici.
https://api.framky.com/api/agent/v1/openapi.yaml
Što je proizvod
Framky je zidna fotogalerija: set okvira od MDF-a s kupčevim fotografijama, otisnutima i isporučenima spremnima za vješanje. Okviri su bez stakla, pa nema odsjaja, a montiraju se samoljepljivim vješalicama — cijela galerija visi na zidu za otprilike 15 minuta.
Što agent može
Otvoriti korisnički račun
Jedan zahtjev vraća agentski token. Ako je e-mail već registriran, kupac dobiva 6-znamenkasti kod kojim autorizira agenta.
Prenijeti fotografije
Multipart prijenos ili izvorni URL — fotografije ulaze u kupčevu biblioteku i koristit će se za galeriju.
Složiti galeriju
Poslužitelj klonira raspored proizvoda i automatski dodjeljuje fotografije okvirima prema razlučivosti i omjeru stranica, zatim renderira vizualni pregled za kupca.
Naručiti i platiti
Kreirajte narudžbu, postavite adresu dostave i primite Stripe poveznicu za plaćanje za kupca.
Tipičan tijek
- 1
Otvorite kupčev račun
POST /accounts - 2
Prenesite kupčeve fotografije
POST /photos - 3
Pregledajte proizvode i odaberite raspored
GET /products - 4
Kreirajte kompoziciju — poslužitelj sam raspoređuje fotografije
POST /compositions - 5
Renderirajte pregled i pokažite ga kupcu
POST /compositions/{id}/preview - 6
Po potrebi ručno doradite kompoziciju — API vraća poveznicu za uređivanje gdje možete promijeniti izrez fotografije ili je zamijeniti drugom
edit_url (from POST /compositions) - 7
Kreirajte narudžbu i postavite adresu dostave
POST /orders + PUT /orders/{id}/shipping-address - 8
Dohvatite Stripe poveznicu za plaćanje i pošaljite je kupcu
POST /orders/{id}/checkout - 9
Provjeravajte narudžbu dok status ne postane „paid”
GET /orders/{id}
OpenAPI shema jedini je izvor istine — ondje su sve sheme zahtjeva i odgovora. Usmjerite na nju svoj agentski framework, GPT Action ili MCP klijent.
Dizajnirano za sigurnu autonomiju
Kupac plaća na stranici koju hostira Stripe u vlastitom pregledniku — API nikada ne prima podatke o kartici od agenta.
Zaglavlje Idempotency-Key čini svaki POST sigurnim za ponavljanje: isti ključ 24 sata vraća izvorni odgovor.
Svaka kompozicija vraća poveznicu za uređivanje kojom kupac sam dotjeruje galeriju u framky.com konfiguratoru.