Un agente de IA puede comprar una galería Framky
La Framky Agent API cubre toda la compra: desde las fotos del cliente hasta el pedido pagado. El pago lo completa el cliente en una página de Stripe, así que el agente nunca toca datos de tarjeta.
https://api.framky.com/api/agent/v1/openapi.yaml
Qué es el producto
Framky es una galería fotográfica de pared: un conjunto de marcos de MDF con las fotos del cliente, impresas y entregadas listas para colgar. Los marcos son sin vidrio, así que no hay reflejos, y se montan con ganchos autoadhesivos: toda la galería está en la pared en unos 15 minutos.
Qué puede hacer un agente
Crear una cuenta de cliente
Una sola petición devuelve un token de agente. Si el correo ya está registrado, el cliente recibe un código de 6 dígitos para autorizar al agente.
Subir fotos
Subida multipart o una URL de origen: las fotos pasan a la biblioteca del cliente y se usarán en la galería.
Componer la galería
El servidor clona la maquetación de un producto y asigna automáticamente las fotos a los marcos según resolución y proporción, y luego genera una vista previa visual para mostrar al cliente.
Pedir y pagar
Haz el pedido, define la dirección de envío y recibe un enlace de pago de Stripe para el cliente.
Flujo típico
- 1
Crear la cuenta del cliente
POST /accounts - 2
Subir las fotos del cliente
POST /photos - 3
Explorar los productos y elegir una composición
GET /products - 4
Crear una composición: el servidor coloca las fotos automáticamente
POST /compositions - 5
Generar una vista previa y mostrársela al cliente
POST /compositions/{id}/preview - 6
Si hace falta, ajusta la composición a mano: la API devuelve un enlace de edición donde puedes cambiar el encuadre de una foto o sustituirla por otra
edit_url (from POST /compositions) - 7
Hacer el pedido y definir la dirección de envío
POST /orders + PUT /orders/{id}/shipping-address - 8
Obtener el enlace de pago de Stripe y enviárselo al cliente
POST /orders/{id}/checkout - 9
Consultar el pedido hasta que su estado sea «paid»
GET /orders/{id}
El esquema OpenAPI es la única fuente de verdad: allí están todos los esquemas de peticiones y respuestas. Apunta hacia él tu framework de agentes, tu GPT Action o tu cliente MCP.
Diseñado para una autonomía segura
El cliente paga en una página alojada por Stripe en su propio navegador: la API nunca acepta datos de tarjeta de un agente.
La cabecera Idempotency-Key hace que cada POST sea seguro de reintentar: la misma clave devuelve la respuesta original durante 24 horas.
Cada composición devuelve un enlace de edición con el que el cliente puede afinar la galería por sí mismo en el configurador de framky.com.