Un agent AI poate cumpăra o galerie Framky
Framky Agent API acoperă întreaga achiziție — de la fotografiile clientului până la comanda plătită. Plata este finalizată de client pe o pagină Stripe, așa că agentul nu atinge niciodată datele cardului.
https://api.framky.com/api/agent/v1/openapi.yaml
Ce este produsul
Framky este o galerie foto de perete: un set de rame din MDF cu fotografiile clientului, tipărite și livrate gata de agățat. Ramele sunt fără sticlă, deci nu există reflexii, și se montează cu suporturi adezive — întreaga galerie este pe perete în aproximativ 15 minute.
Ce poate face un agent
Să creeze un cont de client
O singură cerere returnează un token de agent. Dacă e-mailul este deja înregistrat, clientul primește un cod din 6 cifre cu care autorizează agentul.
Să încarce fotografii
Upload multipart sau un URL sursă — fotografiile intră în biblioteca clientului și vor fi folosite pentru galerie.
Să compună galeria
Serverul clonează aranjarea unui produs și atribuie automat fotografiile ramelor după rezoluție și proporții, apoi generează o previzualizare vizuală de arătat clientului.
Să comande și să plătească
Plasează comanda, setează adresa de livrare și primește un link de plată Stripe pentru client.
Flux tipic
- 1
Creează contul clientului
POST /accounts - 2
Încarcă fotografiile clientului
POST /photos - 3
Răsfoiește produsele și alege un aranjament
GET /products - 4
Creează o compoziție — serverul așază fotografiile automat
POST /compositions - 5
Generează o previzualizare și arat-o clientului
POST /compositions/{id}/preview - 6
Dacă e nevoie, ajustează compoziția manual — API-ul returnează un link de editare unde poți schimba încadrarea unei fotografii sau o poți înlocui cu alta
edit_url (from POST /compositions) - 7
Plasează comanda și setează adresa de livrare
POST /orders + PUT /orders/{id}/shipping-address - 8
Obține linkul de plată Stripe și trimite-l clientului
POST /orders/{id}/checkout - 9
Interoghează comanda până când starea devine „paid”
GET /orders/{id}
Schema OpenAPI este singura sursă de adevăr — acolo se află toate schemele de cereri și răspunsuri. Îndreaptă-ți framework-ul de agenți, GPT Action-ul sau clientul MCP către ea.
Proiectat pentru autonomie sigură
Clientul plătește pe o pagină găzduită de Stripe în propriul browser — API-ul nu acceptă niciodată date de card de la un agent.
Antetul Idempotency-Key face fiecare POST sigur de reîncercat: aceeași cheie returnează răspunsul original timp de 24 de ore.
Fiecare compoziție returnează un link de editare cu care clientul își poate rafina singur galeria în configuratorul framky.com.