Każde SKU Fabrixa, każda tkanina, każde wykończenie — dostępne za pośrednictwem jednego udokumentowanego interfejsu REST API. Dane wejściowe i wyjściowe w formacie JSON. Webhooks przy każdej zmianie stanu. Klucze API self-service — wystarczy utworzyć kanał sprzedaży i zacząć budować.
Udokumentowany interfejs REST API, który odzwierciedla funkcjonalność platformy — zamówienia, realizację zamówień, dostosowywanie Studio oraz webhooki. Dane wejściowe i wyjściowe w formacie JSON. Można z niego korzystać równolegle z Dashboardem lub sterować wszystkim programowo.
Należy przesłać zamówienie zawierające wiersze, pliki PDF źródłowe, dane klienta oraz adres wysyłki. Zwraca identyfikator zamówienia Fabrixa. Opcjonalne pola dotyczące etykiety wysyłkowej i numeru śledzenia.
Pobiera status produkcji dla poszczególnych pozycji: każdy etap (druk, utrwalanie, pranie, szycie) wraz ze statusami „oczekujące”, „w toku”, „zakończone” i „odrzucone”. Można też subskrybować webhooks, aby otrzymywać powiadomienia push.
Zaintegrowaj Fabrixa Studio ze swoją witryną sklepową. Klienci mogą dostosowywać produkty w czasie rzeczywistym dzięki zdarzeniom `postMessage` dla akcji „Dodaj do koszyka” i „Wróć”, a także adresowi URL podglądu miniatur produktów w koszyku.
Dwa topics, payloady podpisane HMAC-SHA256, pełne body zamówienia, 10 prób dostarczenia z back-off.
Uwierzytelnione żądanie, zweryfikowana treść, zarezerwowane miejsce w kolejce produkcyjnej. Potwierdzenie w ciągu milisekund — zamówienie Państwa klienta jest już w trakcie realizacji.
Pełny schemat, wszystkie endpointy, kody błędów, rate limits oraz przykłady integracji znajdują się w dokumentacji technicznej.
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "number": "ORD-2026-0142", "purchased_at": "2026-05-28 14:22:01", "rows": [ { "sku": "COF099191", "quantity": 1, "sources": [ { "type": "file", "url": "https://cdn.you.com/art/9812.pdf" } ] } ], "customer": { "first_name": "Maria", "last_name": "Silva", "email": "maria@example.com", "phone": "+351912345678" }, "shipping_address": { "address": "Rua do Carmo 42", "city": "Lisboa", "postal_code": "1200-094", "country_code": "PT", "country": "Portugal" } }
Bezpośrednia integracja REST z Państwa platformą. Bez wymaganego SDK, bez serwera proxy, bez zewnętrznego konektora. Standardowy HTTP z Państwa stosu do naszego.
Application Access Token i Application Key uzyskują Państwo, tworząc kanał sprzedaży w Dashboardzie. Oba są wymagane w każdym żądaniu: token typu „Bearer” w polu „Authorization”, a klucz aplikacji w polu „X-Application-Key”.
W aktualnej dokumentacji Swagger znajdą Państwo warianty SKU produktów przeznaczonych do sprzedaży, a także wzorce filtrowania i paginacji.
Przy checkoucie wysyłamy żądanie POST zawierające wiersze, źródła (adresy URL plików PDF), dane klienta oraz adres wysyłki. Zapisz zwrócony identyfikator zamówienia Fabrixa wraz z własnym numerem referencyjnym zamówienia.
Wystarczy udostępnić publiczny endpoint POST. Każdy payload podpisujemy HMAC-SHA256 (x-webhook-signature), dzięki czemu można zweryfikować autentyczność przed przetworzeniem.
Opcjonalnie: iframe Fabrixa Studio można umieścić na stronie produktu. Klienci personalizują produkt na bieżąco; swoje dostosowania dołączają do zamówienia za pomocą żądania POST.
Pełna dokumentacja endpointów, schematy żądań i odpowiedzi, kody błędów, rate limits, uwierzytelnianie, Studio embed oraz kontrakty webhooków — wraz z interfejsem Swagger działającym na żywo.
Otwórz dokumentację →Wystarczy utworzyć dedykowany kanał sprzedaży do testów — zamówienia testowe, weryfikacja dostarczania webhooks, przypadki brzegowe — a potem skierować rzeczywisty ruch na kanał produkcyjny. Klucze są gotowe od razu po utworzeniu kanału — bez osobnego wniosku.
Załóż konto →Gotowa kolekcja żądań z przykładowymi payloadami i uwierzytelnianiem. Wystarczy zaimportować ją do procesu testowego.
Zobacz kolekcję →Standardowe procedury, żadnych niespodzianek. Każde żądanie jest uwierzytelniane zarówno za pomocą tokenu typu „Bearer”, jak i klucza aplikacji. Każdy webhook jest podpisany algorytmem HMAC w celu weryfikacji, a limity częstotliwości są przewidywalne dla każdej aplikacji.
Token „Bearer” w nagłówku „Authorization”. Identyfikuje aplikację wywołującą.
Przesyłane w nagłówku X-Application-Key. Oba są wymagane w każdym żądaniu — brak któregokolwiek z nich powoduje zwrot kodu 401.
W serwisie api.fabrixa.com obowiązuje wyłączność protokołu HTTPS. Żądania wysyłane w postaci zwykłego tekstu są odrzucane na poziomie brzegowym.
Każdy webhook jest podpisany algorytmem HMAC-SHA256, a podpis jest przesyłany w nagłówku x-webhook-signature. Należy to zweryfikować przed przetworzeniem.
30 żądań na aplikację na minutę. W każdej odpowiedzi zwracane są pola „X-RateLimit-Limit” i „X-RateLimit-Remaining”.
W przypadku odpowiedzi innej niż 2xx lub 3xx dopuszczalne jest do 10 prób dostarczenia. Po dziesiątej nieudanej próbie webhook zostaje wyłączony.
Każde żądanie musi zawierać dwa nagłówki: token dostępu aplikacji wysłany jako token typu „Bearer” w nagłówku „Authorization” oraz klucz aplikacji w nagłówku „X-Application-Key”. Oba są generowane w momencie utworzenia kanału sprzedaży w panelu Fabrixa, a brak któregokolwiek z tych nagłówków powoduje odrzucenie żądania z kodem błędu 401.
Tak — utwórz dedykowany kanał sprzedaży, na którym będziesz mógł przeprowadzać testy, składać zamówienia testowe, sprawdzać dostarczanie webhooków oraz weryfikować skrajne przypadki, a następnie, gdy kanał będzie już działał, skieruj na niego rzeczywisty ruch. Rejestracja i utworzenie tego kanału sprawia, że token dostępu do aplikacji oraz klucz aplikacji stają się natychmiast dostępne, bez konieczności składania oddzielnego wniosku.
Tak — usługa API na stronie api.fabrixa.com działa wyłącznie w protokole HTTPS, a wszelkie żądania wysyłane w postaci zwykłego tekstu są odrzucane na poziomie brzegowym. Każde żądanie jest również uwierzytelniane zarówno za pomocą tokenu Bearer, jak i klucza aplikacji, a każda treść webhooka jest podpisana algorytmem HMAC-SHA256, co pozwala na jej weryfikację przed przetworzeniem.
Uwierzytelnione żądanie POST wysłane na adres /v2/integration/orders powoduje sprawdzenie poprawności treści żądania, rezerwację miejsca w kolejce produkcyjnej oraz zwraca potwierdzenie zawierające identyfikator zamówienia Fabrixa w milisekundach, a także opcjonalne pola dotyczące etykiety wysyłkowej i śledzenia przesyłki. Realizację zamówienia można następnie śledzić dla poszczególnych pozycji lub otrzymywać powiadomienia za pośrednictwem webhooków.
Nie — integracja z fabrixa polega na bezpośrednim połączeniu REST poprzez standardowy protokół HTTP, bez konieczności korzystania z zestawu SDK, serwera proxy ani zewnętrznego modułu łączącego. Połączenie z fabrixa nawiązuje się bezpośrednio z własnego środowiska za pomocą żądań i odpowiedzi w formacie JSON, a zmiany stanu są sygnalizowane za pomocą webhooków.
Wystarczy się zarejestrować i utworzyć kanał sprzedaży — dane dostępowe do API są gotowe od razu. Potrzebna pomoc? Nasi Solutions Engineers odpowiadają w ciągu 24 godzin — większość zespołów wdraża się w dwa tygodnie.
