Egy AI-ügynök megvásárolhat egy Framky-galériát
A Framky Agent API a teljes vásárlást lefedi — az ügyfél fotóitól a kifizetett rendelésig. A fizetést az ügyfél egy Stripe-oldalon végzi el, így az ügynök soha nem ér kártyaadatokhoz.
https://api.framky.com/api/agent/v1/openapi.yaml
Mi ez a termék
A Framky egy fali fotógaléria: MDF keretek készlete az ügyfél fotóival, kinyomtatva és felakasztásra készen szállítva. A keretek üveg nélkül készülnek, így nincsenek tükröződések, és öntapadós akasztókkal rögzíthetők — a teljes galéria körülbelül 15 perc alatt a falon van.
Mit tehet egy ügynök
Ügyfélfiók létrehozása
Egyetlen kérés ügynök-tokent ad vissza. Ha az e-mail-cím már regisztrálva van, az ügyfél 6 számjegyű kódot kap, amellyel felhatalmazza az ügynököt.
Fotók feltöltése
Multipart feltöltés vagy forrás-URL — a fotók az ügyfél könyvtárába kerülnek, és a galériához lesznek felhasználva.
A galéria összeállítása
A szerver leklónozza egy termék elrendezését, és felbontás meg képarány alapján automatikusan keretekhez rendeli a fotókat, majd vizuális előnézetet renderel, amit megmutathatsz az ügyfélnek.
Rendelés és fizetés
Add le a rendelést, állítsd be a szállítási címet, és kapj Stripe fizetési linket az ügyfél számára.
Tipikus folyamat
- 1
Hozd létre az ügyfélfiókot
POST /accounts - 2
Töltsd fel az ügyfél fotóit
POST /photos - 3
Böngéssz a termékek között és válassz elrendezést
GET /products - 4
Hozz létre kompozíciót — a szerver automatikusan elrendezi a fotókat
POST /compositions - 5
Renderelj előnézetet és mutasd meg az ügyfélnek
POST /compositions/{id}/preview - 6
Ha kell, igazítsd a kompozíciót kézzel — az API szerkesztési linket ad vissza, ahol módosíthatod egy fotó kivágását vagy kicserélheted másikra
edit_url (from POST /compositions) - 7
Add le a rendelést és állítsd be a szállítási címet
POST /orders + PUT /orders/{id}/shipping-address - 8
Kérd le a Stripe fizetési linket és küldd el az ügyfélnek
POST /orders/{id}/checkout - 9
Kérdezd le a rendelést, amíg az állapota „paid” nem lesz
GET /orders/{id}
Az OpenAPI-séma az egyetlen igazságforrás — ott található az összes kérés- és válaszséma. Irányítsd rá az ügynök-keretrendszered, a GPT Actiont vagy az MCP-klienst.
Biztonságos autonómiára tervezve
Az ügyfél a saját böngészőjében, a Stripe által üzemeltetett oldalon fizet — az API soha nem fogad el kártyaadatokat ügynöktől.
Az Idempotency-Key fejléc minden POST-ot biztonságosan újrapróbálhatóvá tesz: ugyanaz a kulcs 24 órán át az eredeti választ adja vissza.
Minden kompozíció szerkesztési linket ad vissza, amellyel az ügyfél maga finomhangolhatja a galériát a framky.com konfigurátorában.