Un agent IA peut acheter une galerie Framky
L'API Framky Agent couvre tout l'achat — des photos du client à la commande payée. Le paiement est finalisé par le client sur une page Stripe : l'agent ne touche jamais aux données de carte.
https://api.framky.com/api/agent/v1/openapi.yaml
Le produit en bref
Framky est une galerie photo murale : un ensemble de cadres en MDF avec les photos du client, imprimées et livrées prêtes à accrocher. Les cadres sont sans verre, donc sans reflets, et se fixent avec des supports adhésifs — toute la galerie est au mur en 15 minutes environ.
Ce qu'un agent peut faire
Créer un compte client
Une seule requête renvoie un jeton d'agent. Si l'e-mail est déjà enregistré, le client reçoit un code à 6 chiffres pour autoriser l'agent.
Téléverser des photos
Upload multipart ou URL source — les photos rejoignent la bibliothèque du client et serviront à la galerie.
Composer la galerie
Le serveur clone la mise en page d'un produit et attribue automatiquement les photos aux cadres selon la résolution et le format, puis génère un aperçu visuel à montrer au client.
Commander et payer
Passez la commande, définissez l'adresse de livraison et recevez un lien de paiement Stripe pour le client.
Déroulé type
- 1
Créer le compte client
POST /accounts - 2
Téléverser les photos du client
POST /photos - 3
Parcourir les produits et choisir une mise en page
GET /products - 4
Créer une composition — le serveur place les photos automatiquement
POST /compositions - 5
Générer un aperçu et le montrer au client
POST /compositions/{id}/preview - 6
Si besoin, ajustez la composition à la main — l'API renvoie un lien d'édition pour modifier le cadrage d'une photo ou la remplacer par une autre
edit_url (from POST /compositions) - 7
Passer la commande et définir l'adresse de livraison
POST /orders + PUT /orders/{id}/shipping-address - 8
Récupérer le lien de paiement Stripe et l'envoyer au client
POST /orders/{id}/checkout - 9
Interroger la commande jusqu'au statut « paid »
GET /orders/{id}
Le schéma OpenAPI est l'unique source de vérité — tous les schémas de requêtes et de réponses s'y trouvent. Pointez-y votre framework d'agents, votre GPT Action ou votre client MCP.
Conçu pour une autonomie sûre
Le client paie sur une page hébergée par Stripe dans son propre navigateur — l'API n'accepte jamais de données de carte venant d'un agent.
L'en-tête Idempotency-Key rend chaque POST rejouable en toute sécurité : la même clé renvoie la réponse d'origine pendant 24 heures.
Chaque composition renvoie un lien d'édition qui permet au client de peaufiner lui-même la galerie dans le configurateur framky.com.