Ein KI-Agent kann eine Framky-Galerie kaufen
Die Framky Agent API deckt den gesamten Kauf ab — von den Fotos des Kunden bis zur bezahlten Bestellung. Die Zahlung schließt der Kunde auf einer Stripe-Seite ab, der Agent berührt also nie Kartendaten.
https://api.framky.com/api/agent/v1/openapi.yaml
Was das Produkt ist
Framky ist eine Fotogalerie für die Wand: ein Set aus MDF-Rahmen mit den Fotos des Kunden, gedruckt und fertig zum Aufhängen geliefert. Die Rahmen sind ohne Glas, es gibt also keine Reflexionen, und sie werden mit selbstklebenden Aufhängern montiert — die ganze Galerie hängt in etwa 15 Minuten an der Wand.
Was ein Agent tun kann
Ein Kundenkonto anlegen
Eine Anfrage liefert ein Agent-Token. Ist die E-Mail bereits registriert, erhält der Kunde einen 6-stelligen Code, mit dem er den Agenten autorisiert.
Fotos hochladen
Multipart-Upload oder eine Quell-URL — die Fotos landen in der Bibliothek des Kunden und werden für die Galerie verwendet.
Die Galerie zusammenstellen
Der Server klont ein Produkt-Layout und weist die Fotos automatisch nach Auflösung und Seitenverhältnis den Rahmen zu, dann rendert er eine visuelle Vorschau für den Kunden.
Bestellen und bezahlen
Bestellung aufgeben, Lieferadresse setzen und einen Stripe-Zahlungslink für den Kunden erhalten.
Typischer Ablauf
- 1
Kundenkonto anlegen
POST /accounts - 2
Fotos des Kunden hochladen
POST /photos - 3
Produkte durchsehen und ein Layout wählen
GET /products - 4
Komposition erstellen — der Server verteilt die Fotos automatisch
POST /compositions - 5
Vorschau rendern und dem Kunden zeigen
POST /compositions/{id}/preview - 6
Bei Bedarf die Komposition manuell anpassen — die API liefert einen Bearbeitungslink, unter dem sich der Zuschnitt eines Fotos ändern oder ein Foto austauschen lässt
edit_url (from POST /compositions) - 7
Bestellung aufgeben und Lieferadresse setzen
POST /orders + PUT /orders/{id}/shipping-address - 8
Stripe-Zahlungslink holen und an den Kunden senden
POST /orders/{id}/checkout - 9
Bestellung abfragen, bis der Status „paid“ ist
GET /orders/{id}
Das OpenAPI-Schema ist die einzige Quelle der Wahrheit — dort liegen alle Request- und Response-Schemata. Richten Sie Ihr Agent-Framework, Ihre GPT Action oder Ihren MCP-Client darauf aus.
Für sichere Autonomie gebaut
Der Kunde zahlt auf einer von Stripe gehosteten Seite im eigenen Browser — die API nimmt von einem Agenten niemals Kartendaten an.
Ein Idempotency-Key-Header macht jeden POST sicher wiederholbar: Derselbe Schlüssel liefert 24 Stunden lang die ursprüngliche Antwort.
Jede Komposition liefert einen Bearbeitungslink, mit dem der Kunde die Galerie selbst im framky.com-Konfigurator verfeinert.