Tekoälyagenteille ja kehittäjille

Tekoälyagentti voi ostaa Framky-gallerian

Framky Agent API kattaa koko ostoksen — asiakkaan valokuvista maksettuun tilaukseen. Asiakas viimeistelee maksun Stripe-sivulla, joten agentti ei koskaan käsittele korttitietoja.

OpenAPI-skeema Interaktiivinen dokumentaatio

https://api.framky.com/api/agent/v1/openapi.yaml

Mikä tuote on

Framky on seinävalokuvagalleria: sarja MDF-kehyksiä asiakkaan valokuvilla, painettuina ja toimitettuina ripustusvalmiina. Kehykset ovat ilman lasia, joten heijastuksia ei ole, ja ne kiinnitetään itseliimautuvilla ripustimilla — koko galleria on seinällä noin 15 minuutissa.

Mitä agentti voi tehdä

Luoda asiakastilin

Yksi pyyntö palauttaa agenttitunnisteen. Jos sähköposti on jo rekisteröity, asiakas saa 6-numeroisen koodin, jolla hän valtuuttaa agentin.

Ladata valokuvia

Multipart-lataus tai lähde-URL — valokuvat siirtyvät asiakkaan kirjastoon ja niitä käytetään galleriaan.

Koota gallerian

Palvelin kloonaa tuotteen asettelun ja sijoittaa valokuvat kehyksiin automaattisesti resoluution ja kuvasuhteen mukaan, ja renderöi sitten visuaalisen esikatselun asiakkaalle näytettäväksi.

Tilata ja maksaa

Tee tilaus, aseta toimitusosoite ja saa Stripe-maksulinkki asiakkaalle.

Tyypillinen kulku

1
Luo asiakkaan tili
POST /accounts
2
Lataa asiakkaan valokuvat
POST /photos
3
Selaa tuotteita ja valitse asettelu
GET /products
4
Luo sommitelma — palvelin asettelee valokuvat automaattisesti
POST /compositions
5
Renderöi esikatselu ja näytä se asiakkaalle
POST /compositions/{id}/preview
6
Hienosäädä sommitelmaa tarvittaessa käsin — API palauttaa muokkauslinkin, jossa voi muuttaa valokuvan rajausta tai vaihtaa sen toiseen
edit_url (from POST /compositions)
7
Tee tilaus ja aseta toimitusosoite
POST /orders + PUT /orders/{id}/shipping-address
8
Hae Stripe-maksulinkki ja lähetä se asiakkaalle
POST /orders/{id}/checkout
9
Kysele tilausta, kunnes sen tila on ”paid”
GET /orders/{id}

OpenAPI-skeema on ainoa totuuden lähde — kaikki pyyntö- ja vastausskeemat ovat siellä. Osoita agenttikehyksesi, GPT Action tai MCP-asiakas siihen.

Suunniteltu turvalliseen autonomiaan

Asiakas maksaa Stripen isännöimällä sivulla omassa selaimessaan — API ei koskaan ota korttitietoja vastaan agentilta.

Idempotency-Key-otsake tekee jokaisesta POSTista turvallisen toistaa: sama avain palauttaa alkuperäisen vastauksen 24 tunnin ajan.

Jokainen sommitelma palauttaa muokkauslinkin, jolla asiakas voi itse hienosäätää galleriaa framky.comin konfiguraattorissa.

Resurssit

Ota yhteyttä integraatiostasi