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 order.created oraz order.updated webhooki, a firma Fabrixa zajmie się drukowaniem, pakowaniem i wysyłką pod Twoją marką — od pojedynczego egzemplarza, na terenie całej UE. Ty tworzysz doświadczenie zakupowe, a my zapewniamy elastyczną 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 wolisz zapoznać się z pełną wersją dokumentacji, pełna Dokumentacja API oraz krok po kroku przewodnik po integracji jesteśmy gotowi, kiedy tylko będziesz gotowy.
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ń.
Skontaktuj się z 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 Twoją marką, z Państwa adresem zwrotnym, a na opakowaniu nie ma żadnych oznaczeń Fabrixa. Twoi klienci nigdy nie dowiedzą się o naszym istnieniu, chyba że im o tym powiesz.
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.
- Realizacja zamówień — śledź 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
klucz_pozycji_koszyka, 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: reaguj na stan, zamiast go sprawdzać
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. Skorzystaj z tej funkcji, aby zsynchronizować status Państwa platformy bez przekraczania limitu operacji.
Biorąc pod uwagę dwa zdarzenia i limit 30 na minutę, poprawnie działająca integracja ledwo osiąga ten limit: wysyłamy zlecenie, a następnie reagujemy 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.
- Wyślij zamówienie — 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. Jeśli chodzi o przykładowy czas realizacji, 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 możesz do zamówienia dołączyć plik PDF gotowy do druku. Z funkcji „Studio” korzystasz tylko wtedy, gdy chcesz, aby kupujący mogli spersonalizować produkt w Państwa sklepie, a projekt ten dołączasz do zamówienia poprzez klucz_pozycji_koszyka.
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ę limit częstotliwości?
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 realizacja zamówień 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, przy pełnym wsparciu Dokumentacja API. Jeśli wolisz 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 chcesz sprawdzić, czy rozwiązanie to pasuje do Państwa platformy, skontaktuj się z naszym zespołem — chętnie omówimy z Państwem Państwa konkretny przypadek zastosowania.
