Rozwiązanie Fabrixa „print on demand” API umożliwia każdej platformie lub witrynie sklepowej POD wysyłanie zamówień oraz śledzenie ich cyklu życia poprzez webhooki order.created oraz order.updated a firma Fabrixa zajmie się drukowaniem, pakowaniem i wysyłką pod własną marką — od pojedynczego egzemplarza, na terenie całej UE. Państwo tworzą doświadczenie zakupowe, a my zapewniamy reaktywną produkcję tekstylną na jej potrzeby. Bez minimalnej wielkości zamówienia, bez opłat konfiguracyjnych, bez oznaczeń marki Fabrixa na paczce.
Ten wpis stanowi przystępny przegląd rozwiązania Integration API (wersja 2) przeznaczony dla programistów rozważających wdrożenie Fabrixa jako warstwy realizacji zamówień. Jeśli wolą Państwo od razu przejrzeć dokumentację referencyjną, pełna Dokumentacja API oraz przewodnik po integracji krok po kroku są gotowe, gdy Państwo są gotowi.
Do czego służy API
Fabrixa to platforma do reaktywnego drukowania na tkaninach: jeden panel do zarządzania kanałami sprzedaży, projektami, produkcją i wysyłką. Większość klientów korzysta z integracji poprzez Shopify, WooCommerce lub Fabrixa Studio. Integracja API stanowi czwartą opcję — stworzoną z myślą o platformach POD oraz programistach, którzy posiadają już własny sklep internetowy i pragną programowej kontroli nad realizacją zamówień.
Państwo wywołują API, aby złożyć zamówienie. Fabrixa zajmuje się jego realizacją: nadruk reaktywny na bawełnie i lnie w Portugalii i Hiszpanii oraz nadruk sublimacyjny na poliestrze w Holandii. Przesyłki są wysyłane pod własną marką, z Państwa adresem zwrotnym, a na opakowaniu nie ma żadnych oznaczeń Fabrixa. Państwa klienci nigdy nie dowiedzą się o naszym istnieniu, chyba że im Państwo o tym powiedzą.
Jak działa API
- Ping — prosta kontrola stanu, która pozwala sprawdzić, czy dane uwierzytelniające i połączenie działają prawidłowo, zanim wyślesz jakiekolwiek rzeczywiste dane.
- Produkty — zapoznaj się z katalogiem, na podstawie którego tworzysz ofertę: odzież, tekstylia domowe i tkaniny na metry, wraz z podstawowymi wzorami i wariantami dostępnymi do nadruku.
- Zamówienia — utworzyć zamówienie i sprawdzić jego status. To jest sedno każdej integracji: wprowadzamy wiersze, źródła, dane klienta i wysyłki, a w zamian otrzymujemy zamówienie z możliwością śledzenia.
- Fulfilment — śledzą Państwo proces produkcji i wysyłki w miarę wytwarzania i wysyłania produktów, dzięki czemu Państwa platforma będzie mogła przedstawiać sprzedawcom dokładne informacje o statusie.
- Studio — dołącz spersonalizowany projekt w Fabrixa Studio (nasze narzędzie do personalizacji produktów, które można osadzić na własnej stronie i oznaczyć własną marką) do zamówienia na podstawie jego
cart_item_key, więc to, co zaprojektował nabywca, jest dokładnie tym, co zostanie wydrukowane.
Uwierzytelnianie i limity częstotliwości
Integracja API (wersja 2) znajduje się pod adresem bazowym https://api.fabrixa.com/v2/integration. Każde żądanie zawiera dwa nagłówki:
| Nagłówek | Cel |
|---|---|
Autoryzacja: na okaziciela |
Państwa token API — służy do identyfikacji i autoryzacji żądania. |
X-Application-Key: |
Klucz aplikacji — stanowi parę z tokenem, więc oba muszą być obecne. |
Limit częstotliwości wynosi 30 żądań na minutę. To wystarczająca przepustowość dla ruchu generowanego przez zamówienia, ale oznacza to, że operacje masowe powinny być rozłożone w czasie, a nie wykonywane w krótkich cyklach. Należy płynnie radzić sobie z tym ograniczeniem, zwalniać tempo po jego osiągnięciu i korzystać z webhooków (patrz poniżej) zamiast metod odpytywania.
Webhooki: reagowanie na stan, nie odpytywanie o niego
Zamiast ciągle pytać “czy to już gotowe?”, zasubskrybuj webhooki i pozwól, by Fabrixa powiadamiało Państwa o wszelkich zmianach. Integracja API generuje dwa zdarzenia:
- order.created — uruchamia się po przyjęciu zamówienia do realizacji. Służy do potwierdzenia odbioru sprzedawcy oraz oznaczenia zamówienia jako realizowane.
- order.updated — uruchamia się w miarę przechodzenia zamówienia przez kolejne etapy produkcji i wysyłki, w tym podczas śledzenia przesyłki. Mogą Państwo skorzystać z tej funkcji, aby zsynchronizować status platformy bez przekraczania rate limit.
Biorąc pod uwagę dwa zdarzenia i limit 30 na minutę, poprawnie działająca integracja ledwo zbliża się do tego limitu: należy wysłać zamówienie, a następnie zareagować na otrzymaną odpowiedź.
Przepływ zleceń – od początku do końca
Niezależnie od tego, którą opcję wybierzesz, schemat jest taki sam:
- Połącz się — sklep (Shopify lub WooCommerce) albo API.
- Projekt — dostosuj projekt w programie Fabrixa Studio lub dostarcz plik PDF gotowy do druku.
- Wysłanie zamówienia — za pośrednictwem API, wraz z wierszami dotyczącymi produktów, danymi klienta oraz adresem wysyłki.
- Zajmujemy się produkcją i wysyłką — Fabrixa zajmuje się drukowaniem, pakowaniem i wysyłką produktów pod marką własną.
Krótka uwaga na temat jakości, bo właśnie dlatego sprzedawcy wybierają barwniki reaktywne: barwnik reaktywny tworzy wiązanie kowalencyjne z celulozą zawartą w włóknie bawełnianym i zostaje trwale utrwalony pod wpływem ciepła i pary. Kolor staje się częścią włókna — nie ma warstwy powierzchniowej, nie pęka w miejscach zginania — dzięki czemu w dotyku przypomina bawełnę bez nadruku i zazwyczaj zachowuje kolor przez ponad 600 cykli prania. Jako przykład czasu produkcji, odzież produkowana w Portugalii jest gotowa w ciągu około 6–9 dni roboczych.
Dlaczego platformy opierają się na modelu Fabrixa
- MOQ 1 — od jednej sztuki do dziesiątek tysięcy. Brak minimalnej wielkości zamówienia, brak opłat za przygotowanie produkcji, brak umów.
- Domyślnie w wersji white-label — na każdej paczce widnieje marka klienta, a nie nasza.
- Krótki łańcuch dostaw w UE — transport w obrębie Portugalii, Hiszpanii i Holandii, a nie transport dalekobieżny.
- Prawdziwy druk reaktywny — Bawełna organiczna z certyfikatem GOTS jako standardowa podstawa, a także certyfikaty OEKO-TEX Standard 100 i Made in Green.
Najczęściej zadawane pytania
Czy muszę korzystać z programu Fabrixa Studio, aby móc używać API?
Nie. Funkcja „Studio” jest opcjonalna. Zamiast tego mogą Państwo do zamówienia dołączyć plik PDF gotowy do druku. Z funkcji „Studio” korzysta się tylko wtedy, gdy chcą Państwo, aby kupujący mogli spersonalizować produkt w Państwa sklepie, a projekt ten dołącza się do zamówienia poprzez cart_item_key.
Jak uwierzytelnić żądania?
Przy każdym wywołaniu wysyłaj dwa nagłówki: Autoryzacja: na okaziciela oraz X-Application-Key:. Oba elementy są wymagane — brak jednego z nich spowoduje odrzucenie wniosku.
Co się stanie, jeśli osiągnę rate limit?
Limit dla API wynosi 30 żądań na minutę. Jeśli go przekroczysz, poczekaj chwilę i spróbuj ponownie, zamiast nieustannie wysyłać żądania do punktu końcowego. W przypadku zmian statusu użyj order.created oraz order.updated webhooki zamiast odpytywania — zapewniają synchronizację bez zużywania żądań.
Czy fulfilment to naprawdę rozwiązanie typu white label?
Tak. Przesyłki są wysyłane pod Państwa marką, z Państwa adresem zwrotnym, a oznaczenia Fabrixa nie pojawiają się w standardzie. Państwa klienci końcowi nigdy nas nie widzą.
Zacznij tworzyć
Najszybszym sposobem na wejście jest przewodnik po integracji, a wspiera go pełna Dokumentacja API. Jeśli wolą Państwo najpierw zobaczyć, jak to wszystko do siebie pasuje, to przegląd platformy przechodzi przez kolejne etapy: kanały, Studio, produkcję i wysyłkę. A jeśli chcą Państwo sprawdzić, czy rozwiązanie to pasuje do Państwa platformy, proszę porozmawiać z naszym zespołem — chętnie omówimy z Państwem Państwa konkretny przypadek zastosowania.
