Agent AI może kupić galerię Framky
Framky Agent API obejmuje cały zakup — od zdjęć klienta po opłacone zamówienie. Płatność klient finalizuje na stronie Stripe, więc agent nigdy nie dotyka danych karty.
https://api.framky.com/api/agent/v1/openapi.yaml
Czym jest produkt
Framky to galeria zdjęć w ramkach na ścianę: zestaw ramek z MDF ze zdjęciami klienta, wydrukowanymi i dostarczonymi w formie gotowej do powieszenia. Ramki są bez szkła, więc nie ma odbłysków, a montaż odbywa się na wieszaki samoprzylepne — cała galeria wisi na ścianie w około 15 minut.
Co może zrobić agent
Założyć konto klienta
Jedno żądanie zwraca token agenta. Jeśli e-mail jest już zarejestrowany, klient otrzymuje 6-cyfrowy kod, którym autoryzuje agenta.
Przesłać zdjęcia
Upload multipart albo adres URL źródła — zdjęcia trafiają do biblioteki klienta i posłużą do galerii.
Skomponować galerię
Serwer klonuje układ produktu i automatycznie przypisuje zdjęcia do ramek według rozdzielczości i proporcji, a następnie renderuje podgląd do pokazania klientowi.
Zamówić i opłacić
Złóż zamówienie, ustaw adres dostawy i odbierz link do płatności Stripe dla klienta.
Typowy przebieg
- 1
Załóż konto klienta
POST /accounts - 2
Prześlij zdjęcia klienta
POST /photos - 3
Przejrzyj produkty i wybierz układ
GET /products - 4
Utwórz kompozycję — serwer sam rozmieści zdjęcia
POST /compositions - 5
Wyrenderuj podgląd i pokaż go klientowi
POST /compositions/{id}/preview - 6
W razie potrzeby wyedytuj kompozycję ręcznie — API zwraca link do edycji, pod którym zmienisz kadrowanie zdjęcia albo zamienisz je na inne
edit_url (from POST /compositions) - 7
Złóż zamówienie i ustaw adres dostawy
POST /orders + PUT /orders/{id}/shipping-address - 8
Pobierz link do płatności Stripe i wyślij go klientowi
POST /orders/{id}/checkout - 9
Odpytuj zamówienie, aż status będzie „paid”
GET /orders/{id}
Schemat OpenAPI to jedyne źródło prawdy — są tam wszystkie schematy żądań i odpowiedzi. Wskaż go swojemu frameworkowi agentowemu, GPT Action albo klientowi MCP.
Zaprojektowane z myślą o bezpiecznej autonomii
Klient płaci na stronie Stripe we własnej przeglądarce — API nigdy nie przyjmuje danych karty od agenta.
Nagłówek Idempotency-Key sprawia, że każdy POST można bezpiecznie ponowić: ten sam klucz przez 24 godziny zwraca pierwotną odpowiedź.
Każda kompozycja zwraca link do edycji, dzięki któremu klient sam dopracuje galerię w konfiguratorze framky.com.