Un agente IA può comprare una galleria Framky
La Framky Agent API copre l'intero acquisto: dalle foto del cliente all'ordine pagato. Il pagamento viene completato dal cliente su una pagina Stripe, quindi l'agente non tocca mai i dati della carta.
https://api.framky.com/api/agent/v1/openapi.yaml
Che cos'è il prodotto
Framky è una galleria fotografica da parete: un set di cornici in MDF con le foto del cliente, stampate e consegnate pronte da appendere. Le cornici sono senza vetro, quindi niente riflessi, e si montano con ganci autoadesivi: l'intera galleria è a parete in circa 15 minuti.
Cosa può fare un agente
Creare un account cliente
Una sola richiesta restituisce un token agente. Se l'e-mail è già registrata, il cliente riceve un codice a 6 cifre per autorizzare l'agente.
Caricare le foto
Upload multipart o URL di origine: le foto entrano nella libreria del cliente e verranno usate per la galleria.
Comporre la galleria
Il server clona il layout di un prodotto e assegna automaticamente le foto alle cornici in base a risoluzione e proporzioni, poi genera un'anteprima visiva da mostrare al cliente.
Ordinare e pagare
Effettua l'ordine, imposta l'indirizzo di spedizione e ricevi un link di pagamento Stripe per il cliente.
Flusso tipico
- 1
Creare l'account del cliente
POST /accounts - 2
Caricare le foto del cliente
POST /photos - 3
Sfogliare i prodotti e scegliere un layout
GET /products - 4
Creare una composizione: il server dispone le foto automaticamente
POST /compositions - 5
Generare un'anteprima e mostrarla al cliente
POST /compositions/{id}/preview - 6
Se serve, rifinisci la composizione a mano: l'API restituisce un link di modifica dove cambiare il ritaglio di una foto o sostituirla con un'altra
edit_url (from POST /compositions) - 7
Effettuare l'ordine e impostare l'indirizzo di spedizione
POST /orders + PUT /orders/{id}/shipping-address - 8
Ottenere il link di pagamento Stripe e inviarlo al cliente
POST /orders/{id}/checkout - 9
Interrogare l'ordine finché lo stato non è “paid”
GET /orders/{id}
Lo schema OpenAPI è l'unica fonte di verità: lì si trovano tutti gli schemi di richieste e risposte. Puntaci il tuo framework di agenti, la tua GPT Action o il tuo client MCP.
Progettato per un'autonomia sicura
Il cliente paga su una pagina ospitata da Stripe nel proprio browser: l'API non accetta mai dati di carta da un agente.
L'header Idempotency-Key rende ogni POST sicuro da ripetere: la stessa chiave restituisce la risposta originale per 24 ore.
Ogni composizione restituisce un link di modifica con cui il cliente può rifinire da sé la galleria nel configuratore framky.com.
Risorse
- Schema OpenAPI 3 (YAML)
https://api.framky.com/api/agent/v1/openapi.yaml - Schema OpenAPI 3 (JSON)
https://api.framky.com/api/agent/v1/openapi.json - Documentazione interattiva dell'API
https://api.framky.com/api/agent/v1/docs/ - llms.txt — panoramica del sito leggibile dalle macchine
https://framky.com/llms.txt