Przejdź do głównej treści
Żądanie Fabrixa API wyświetlone na ekranie — dane JSON zamówienia wraz z nagłówkami uwierzytelniającymi, dotyczące tkaniny
Dokumentacja API

Jeden endpoint. Nieskończone produkty.

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ć.

REST · JSON · Webhooks · Studio embed · Swagger

Co otrzymujesz

Opracowane w oparciu o rzeczywisty przebieg produkcji.

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.

01
Zamówienia
POST /v2/integration/orders

Prześlij 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.

02
Fulfilment
GET /orders/{id}/fulfillments

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.

03
Studio
osadzenie ramki iframe

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.

04
Webhooki
order.created / order.updated

Dwa topics, payloady podpisane HMAC-SHA256, pełne body zamówienia, 10 prób dostarczenia z back-off.

Szybki start

Złóż zamówienie w jednym wpisie POST.

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 /v2/integration/orders
// 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"
  }
}
Schemat integracji

Wdrożenie w dwa tygodnie. Bez proxy, bez middleware.

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.

01
Dane uwierzytelniające

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”.

02
Katalog

W aktualnej dokumentacji Swagger znajdą Państwo warianty SKU produktów przeznaczonych do sprzedaży, a także wzorce filtrowania i paginacji.

03
Zamówienia

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.

04
Webhooki

Wystarczy udostępnić publiczny endpoint POST. Każdy payload podpisujemy HMAC-SHA256 (x-webhook-signature), dzięki czemu można zweryfikować autentyczność przed przetworzeniem.

05
Studio

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.

Materiały dla programistów

Wszystko, czego potrzebuje Państwa zespół inżynierski.

Pełna dokumentacja API

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ę →

Twórz w oparciu o kanał sprzedaży

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 →

Kolekcja Postman

Gotowa kolekcja żądań z przykładowymi payloadami i uwierzytelnianiem. Wystarczy zaimportować ją do procesu testowego.

Zobacz kolekcję →
Bezpieczeństwo

Uwierzytelnianie dwuskładnikowe. Podpisane webhooki. Ograniczenie częstotliwości.

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 dostępu do aplikacji

Token „Bearer” w nagłówku „Authorization”. Identyfikuje aplikację wywołującą.

Klucz aplikacji

Przesyłane w nagłówku X-Application-Key. Oba są wymagane w każdym żądaniu — brak któregokolwiek z nich powoduje zwrot kodu 401.

Szyfrowanie TLS

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.

Podpisy webhooków

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.

Limity częstotliwości

30 żądań na aplikację na minutę. W każdej odpowiedzi zwracane są pola „X-RateLimit-Limit” i „X-RateLimit-Remaining”.

Ponowne próby wysłania webhooka

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.

Zacznij tworzyć

Stwórz kanał sprzedaży i zacznij go rozwijać już dziś.

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.