Ένας AI agent μπορεί να αγοράσει μια γκαλερί Framky
Το Framky Agent API καλύπτει ολόκληρη την αγορά — από τις φωτογραφίες του πελάτη έως την πληρωμένη παραγγελία. Την πληρωμή την ολοκληρώνει ο πελάτης σε σελίδα Stripe, οπότε ο agent δεν αγγίζει ποτέ στοιχεία κάρτας.
https://api.framky.com/api/agent/v1/openapi.yaml
Τι είναι το προϊόν
Το Framky είναι ένας τοίχος φωτογραφικής γκαλερί: ένα σετ από κορνίζες MDF με τις φωτογραφίες του πελάτη, τυπωμένες και παραδομένες έτοιμες για ανάρτηση. Οι κορνίζες είναι χωρίς γυαλί, άρα δεν υπάρχουν αντανακλάσεις, και τοποθετούνται με αυτοκόλλητες κρεμάστρες — ολόκληρη η γκαλερί είναι στον τοίχο σε περίπου 15 λεπτά.
Τι μπορεί να κάνει ένας agent
Δημιουργία λογαριασμού πελάτη
Ένα αίτημα επιστρέφει token του agent. Αν το e-mail είναι ήδη καταχωρισμένο, ο πελάτης λαμβάνει 6ψήφιο κωδικό για να εξουσιοδοτήσει τον agent.
Ανέβασμα φωτογραφιών
Multipart upload ή URL προέλευσης — οι φωτογραφίες μπαίνουν στη βιβλιοθήκη του πελάτη και θα χρησιμοποιηθούν για την γκαλερί.
Σύνθεση της γκαλερί
Ο διακομιστής κλωνοποιεί τη διάταξη ενός προϊόντος και αναθέτει αυτόματα τις φωτογραφίες στις κορνίζες βάσει ανάλυσης και αναλογιών, έπειτα αποδίδει μια οπτική προεπισκόπηση για τον πελάτη.
Παραγγελία και πληρωμή
Καταχωρίστε την παραγγελία, ορίστε τη διεύθυνση αποστολής και λάβετε σύνδεσμο πληρωμής Stripe για τον πελάτη.
Τυπική ροή
- 1
Δημιουργήστε τον λογαριασμό του πελάτη
POST /accounts - 2
Ανεβάστε τις φωτογραφίες του πελάτη
POST /photos - 3
Δείτε τα προϊόντα και επιλέξτε διάταξη
GET /products - 4
Δημιουργήστε σύνθεση — ο διακομιστής τοποθετεί τις φωτογραφίες αυτόματα
POST /compositions - 5
Αποδώστε προεπισκόπηση και δείξτε την στον πελάτη
POST /compositions/{id}/preview - 6
Αν χρειαστεί, προσαρμόστε τη σύνθεση χειροκίνητα — το API επιστρέφει σύνδεσμο επεξεργασίας όπου αλλάζετε το κάδρο μιας φωτογραφίας ή την αντικαθιστάτε με άλλη
edit_url (from POST /compositions) - 7
Καταχωρίστε την παραγγελία και ορίστε τη διεύθυνση αποστολής
POST /orders + PUT /orders/{id}/shipping-address - 8
Λάβετε τον σύνδεσμο πληρωμής Stripe και στείλτε τον στον πελάτη
POST /orders/{id}/checkout - 9
Ελέγχετε την παραγγελία μέχρι η κατάσταση να γίνει «paid»
GET /orders/{id}
Το σχήμα OpenAPI είναι η μοναδική πηγή αλήθειας — εκεί βρίσκονται όλα τα σχήματα αιτημάτων και αποκρίσεων. Στρέψτε εκεί το agent framework σας, το GPT Action ή τον MCP client σας.
Σχεδιασμένο για ασφαλή αυτονομία
Ο πελάτης πληρώνει σε σελίδα που φιλοξενεί το Stripe στον δικό του browser — το API δεν δέχεται ποτέ στοιχεία κάρτας από agent.
Η κεφαλίδα Idempotency-Key κάνει κάθε POST ασφαλές για επανάληψη: το ίδιο κλειδί επιστρέφει την αρχική απόκριση για 24 ώρες.
Κάθε σύνθεση επιστρέφει σύνδεσμο επεξεργασίας με τον οποίο ο πελάτης τελειοποιεί μόνος του την γκαλερί στον διαμορφωτή του framky.com.