Przegląd endpointów
Tabela odzwierciedla publiczne routy montowane w backend-public-api/app.js. Ścieżki pokazują publiczny prefiks reverse proxy używany przez integracje zewnętrzne.
| Metoda | Endpoint | Opis | Dostęp |
|---|---|---|---|
GET | /public-api/healthz | Health check serwisu. | publiczny |
GET | /public-api/v1/auth/check | Waliduje credentiale i zwraca storefront, scope’y oraz możliwości planu. | dowolny uwierzytelniony credential |
GET | /public-api/v1/customer-orders | Zwraca paginowaną i filtrowalną listę zamówień klientów. | orders:read |
GET | /public-api/v1/customer-orders/:id | Zwraca pojedyncze zamówienie klienta ze skonfigurowanymi pozycjami. | orders:read |
POST | /public-api/v1/customer-orders/batch | Zwraca maksymalnie 100 zamówień na podstawie ID. | orders:read |
PATCH | /public-api/v1/customer-orders/:id/status | Aktualizuje status zamówienia. | orders:write |
PATCH | /public-api/v1/customer-orders/:orderId/quantity | Aktualizuje ilości wybranych pozycji zamówienia. | orders:write |
PATCH | /public-api/v1/customer-orders/:orderId/quantity/all | Ustawia jedną ilość dla wszystkich pozycji zamówienia. | orders:write |
DELETE | /public-api/v1/customer-orders/:id | Usuwa zamówienie klienta należące do właściciela storefrontu. | orders:write |
GET | /public-api/v1/products | Zwraca produkty/designy storefrontu z dostępnością embed i URL-ami mediów. | products:read |
GET | /public-api/v1/products/:id | Zwraca pojedynczy produkt/design storefrontu. | products:read |
POST | /public-api/v1/embed/session | Wystawia krótkotrwały JWT dla osadzonych narzędzi, w tym generatora modeli. | embed:session:create |
GET | /public-api/v1/runtime/bootstrap | Rozwiązuje kontekst runtime z tokenu embed JWT. | token embed Bearer |
GET | /public-api/v1/assets | Listuje assety katalogu dla wskazanego typu. | dowolny uwierzytelniony credential |
GET | /public-api/v1/assets/:type/:assetId | Zwraca manifest assetu z rolami plików do pobrania. | dowolny uwierzytelniony credential |
GET | /public-api/v1/assets/:type/:assetId/files/:role | Pobiera plik assetu po roli. | dowolny uwierzytelniony credential |
GET | /public-api/v1/design-imports | Listuje designy dostępne do importu. | uwierzytelniony credential, wymagany plan Business |
GET | /public-api/v1/design-imports/:id | Zwraca payload importu designu i deskryptory plików. | uwierzytelniony credential, wymagany plan Business |
GET | /public-api/v1/design-imports/:id/files/:fileId | Pobiera plik z deskryptora importu designu. | uwierzytelniony credential, wymagany plan Business |
GET | /public-api/v1/file/public/products/:productId/:size | Zwraca publiczny podgląd produktu. Size musi mieć wartość small.png, medium.png albo big.png. | publiczny |
GET | /public-api/v1/file/protected/:key | Zwraca chroniony plik po storage key. | podpisany URL albo files:read |
GET | /public-api/v1/fonts | Zwraca wszystkie dostępne fonty. | publiczny |
GET | /public-api/v1/currencies | Zwraca wszystkie waluty. | publiczny |
POST | /public-api/v1/runtime-bindings/sync-from-wordpress | Tworzy lub aktualizuje runtime bindings z mapowań produktów WordPress. | dowolny uwierzytelniony credential |
PATCH | /public-api/v1/runtime-bindings/:id | Aktualizuje runtime binding. | dowolny uwierzytelniony credential |
POST | /public-api/v1/runtime-bindings/:id/activate | Aktywuje runtime binding. | dowolny uwierzytelniony credential |
POST | /public-api/v1/runtime-bindings/:id/deactivate | Dezaktywuje runtime binding. | dowolny uwierzytelniony credential |
POST | /public-api/v1/wp-connect/exchange | Wymienia kod handoff WordPress auto-connect na credentiale API. | jednorazowy kod handoff |
GET | /public-api/v1/model-generator/catalog | Wyświetla widoczne produkty generatora, konfiguracje i rewizje templatek. | embed:session:create |
GET | /public-api/v1/model-generator/models | Wyświetla modele z deskryptorami wskazującymi konkretne rewizje źródeł generatora do importu. | embed:session:create |
GET | /public-api/v1/model-generator/designer-catalog | Zwraca katalog modeli generatora używany przez Designera. | embed:session:create |
GET | /public-api/v1/model-generator/projects | Wyświetla projekty generatora właściciela oraz dostępne globalnie. | embed:session:create |
GET | /public-api/v1/model-generator/projects/:projectId | Zwraca najnowszą lub wskazaną rewizję projektu, templatkę i manifest plików. | embed:session:create |
GET | /public-api/v1/model-generator/projects/:projectId/revisions/:revision | Zwraca najnowszą lub wskazaną rewizję projektu, templatkę i manifest plików. | embed:session:create |
GET | /public-api/v1/model-generator/projects/:projectId/artifacts/:artifactId | Pobiera artefakt po sprawdzeniu dostępu do jego projektu. | embed:session:create |
GET | /public-api/v1/model-generator/configurations/:configurationId/revisions/:revision/template | Zwraca dostępną templatkę dla wybranej rewizji konfiguracji. | embed:session:create |
GET | /public-api/v1/model-generator/configurations/:configurationId/revisions/:revision/import | Zwraca pakiet importu templatki wraz z plikami zależności. | embed:session:create |
GET | /public-api/v1/model-generator/mannequins | Zwraca oba manekiny i deskryptory ich zasobów. | embed:session:create |
GET | /public-api/v1/model-generator/image-libraries/:kind/assets | Wyświetla zasoby biblioteki tekstur lub teł wraz z plikami do importu. | embed:session:create |
GET | /public-api/v1/model-generator/image-libraries/:kind/assets/:assetId | Zwraca jeden zasób tekstury lub tła wraz z plikami do importu. | embed:session:create |
GET | /public-api/v1/model-generator/public-files/:key | Pobiera dozwolony plik zależności generatora. | embed:session:create |