{"id":212,"date":"2026-06-27T10:00:00","date_gmt":"2026-06-27T08:00:00","guid":{"rendered":"https:\/\/www.fabrixa.com\/?p=212"},"modified":"2026-06-27T10:00:00","modified_gmt":"2026-06-27T08:00:00","slug":"reaktywny-interfejs-api-drukowania-dla-platform-typu-pod","status":"publish","type":"post","link":"https:\/\/www.fabrixa.com\/pl\/reactive-print-api-for-pod-platforms\/","title":{"rendered":"Rozwini\u0119cie koncepcji Fabrixa: Reactive-Print API dla platform POD"},"content":{"rendered":"<p>Rozwi\u0105zanie Fabrixa \u201eprint on demand\u201d API umo\u017cliwia ka\u017cdej platformie lub witrynie sklepowej POD wysy\u0142anie zam\u00f3wie\u0144 oraz \u015bledzenie ich cyklu \u017cycia poprzez <strong>order.created<\/strong> oraz <strong>order.updated<\/strong> webhooki, a firma Fabrixa zajmie si\u0119 drukowaniem, pakowaniem i wysy\u0142k\u0105 pod Twoj\u0105 mark\u0105 \u2014 od pojedynczego egzemplarza, na terenie ca\u0142ej UE. Ty tworzysz do\u015bwiadczenie zakupowe, a my zapewniamy elastyczn\u0105 produkcj\u0119 tekstyln\u0105 na jej potrzeby. Bez minimalnej wielko\u015bci zam\u00f3wienia, bez op\u0142at konfiguracyjnych, bez oznacze\u0144 marki Fabrixa na paczce.<\/p>\n<p>Ten wpis stanowi przyst\u0119pny przegl\u0105d rozwi\u0105zania Integration API (wersja 2) przeznaczony dla programist\u00f3w rozwa\u017caj\u0105cych wdro\u017cenie Fabrixa jako warstwy realizacji zam\u00f3wie\u0144. Je\u015bli wolisz zapozna\u0107 si\u0119 z pe\u0142n\u0105 wersj\u0105 dokumentacji, pe\u0142na <a href=\"\/pl\/programisci\/dokumentacja-api\/\">Dokumentacja API<\/a> oraz krok po kroku <a href=\"\/pl\/programisci\/przewodnik-po-integracji\/\">przewodnik po integracji<\/a> jeste\u015bmy gotowi, kiedy tylko b\u0119dziesz gotowy.<\/p>\n<h2>Do czego s\u0142u\u017cy API<\/h2>\n<p>Fabrixa to <a href=\"\/pl\/platforma\/\">platforma do reaktywnego drukowania na tkaninach<\/a>: jeden panel do zarz\u0105dzania kana\u0142ami sprzeda\u017cy, projektami, produkcj\u0105 i wysy\u0142k\u0105. Wi\u0119kszo\u015b\u0107 klient\u00f3w korzysta z integracji poprzez Shopify, WooCommerce lub Fabrixa Studio. Integracja API stanowi czwart\u0105 opcj\u0119 \u2014 stworzon\u0105 z my\u015bl\u0105 o platformach POD oraz programistach, kt\u00f3rzy posiadaj\u0105 ju\u017c w\u0142asny sklep internetowy i pragn\u0105 programowej kontroli nad realizacj\u0105 zam\u00f3wie\u0144.<\/p>\n<p>Skontaktuj si\u0119 z API, aby z\u0142o\u017cy\u0107 zam\u00f3wienie. Fabrixa zajmuje si\u0119 jego realizacj\u0105: nadruk reaktywny na bawe\u0142nie i lnie w Portugalii i Hiszpanii oraz nadruk sublimacyjny na poliestrze w Holandii. Przesy\u0142ki s\u0105 wysy\u0142ane pod Twoj\u0105 mark\u0105, z Pa\u0144stwa adresem zwrotnym, a na opakowaniu nie ma \u017cadnych oznacze\u0144 Fabrixa. Twoi klienci nigdy nie dowiedz\u0105 si\u0119 o naszym istnieniu, chyba \u017ce im o tym powiesz.<\/p>\n<h2>Jak dzia\u0142a API<\/h2>\n<ul>\n<li><strong>Ping<\/strong> \u2014 prosta kontrola stanu, kt\u00f3ra pozwala sprawdzi\u0107, czy dane uwierzytelniaj\u0105ce i po\u0142\u0105czenie dzia\u0142aj\u0105 prawid\u0142owo, zanim wy\u015blesz jakiekolwiek rzeczywiste dane.<\/li>\n<li><strong>Produkty<\/strong> \u2014 zapoznaj si\u0119 z katalogiem, na podstawie kt\u00f3rego tworzysz ofert\u0119: odzie\u017c, tekstylia domowe i tkaniny na metry, wraz z podstawowymi wzorami i wariantami dost\u0119pnymi do nadruku.<\/li>\n<li><strong>Zam\u00f3wienia<\/strong> \u2014 utworzy\u0107 zam\u00f3wienie i sprawdzi\u0107 jego status. To jest sedno ka\u017cdej integracji: wprowadzamy wiersze, \u017ar\u00f3d\u0142a, dane klienta i wysy\u0142ki, a w zamian otrzymujemy zam\u00f3wienie z mo\u017cliwo\u015bci\u0105 \u015bledzenia.<\/li>\n<li><strong>Realizacja zam\u00f3wie\u0144<\/strong> \u2014 \u015bled\u017a proces produkcji i wysy\u0142ki w miar\u0119 wytwarzania i wysy\u0142ania produkt\u00f3w, dzi\u0119ki czemu Pa\u0144stwa platforma b\u0119dzie mog\u0142a przedstawia\u0107 sprzedawcom dok\u0142adne informacje o statusie.<\/li>\n<li><strong>Studio<\/strong> \u2014 do\u0142\u0105cz spersonalizowany projekt w <strong>Fabrixa Studio<\/strong> (nasze narz\u0119dzie do personalizacji produkt\u00f3w, kt\u00f3re mo\u017cna osadzi\u0107 na w\u0142asnej stronie i oznaczy\u0107 w\u0142asn\u0105 mark\u0105) do zam\u00f3wienia na podstawie jego <code>klucz_pozycji_koszyka<\/code>, wi\u0119c to, co zaprojektowa\u0142 nabywca, jest dok\u0142adnie tym, co zostanie wydrukowane.<\/li>\n<\/ul>\n<h2>Uwierzytelnianie i limity cz\u0119stotliwo\u015bci<\/h2>\n<p>Integracja API (wersja 2) znajduje si\u0119 pod adresem bazowym <code>https:\/\/api.fabrixa.com\/v2\/integration<\/code>. Ka\u017cde \u017c\u0105danie zawiera <strong>dwa nag\u0142\u00f3wki<\/strong>:<\/p>\n<table>\n<thead>\n<tr>\n<th>Nag\u0142\u00f3wek<\/th>\n<th>Cel<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>Autoryzacja: na okaziciela<\/code><\/td>\n<td>Pa\u0144stwa token API \u2014 s\u0142u\u017cy do identyfikacji i autoryzacji \u017c\u0105dania.<\/td>\n<\/tr>\n<tr>\n<td><code>X-Application-Key:<\/code><\/td>\n<td>Klucz aplikacji \u2014 stanowi par\u0119 z tokenem, wi\u0119c oba musz\u0105 by\u0107 obecne.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Limit cz\u0119stotliwo\u015bci wynosi <strong>30 \u017c\u0105da\u0144 na minut\u0119<\/strong>. To wystarczaj\u0105ca przepustowo\u015b\u0107 dla ruchu generowanego przez zam\u00f3wienia, ale oznacza to, \u017ce operacje masowe powinny by\u0107 roz\u0142o\u017cone w czasie, a nie wykonywane w kr\u00f3tkich cyklach. Nale\u017cy p\u0142ynnie radzi\u0107 sobie z tym ograniczeniem, zwalnia\u0107 tempo po jego osi\u0105gni\u0119ciu i korzysta\u0107 z webhook\u00f3w (patrz poni\u017cej) zamiast metod odpytywania.<\/p>\n<h2>Webhooki: reaguj na stan, zamiast go sprawdza\u0107<\/h2>\n<p>Zamiast ci\u0105gle pyta\u0107 \u201cczy to ju\u017c gotowe?\u201d, zasubskrybuj webhooki i pozw\u00f3l, by Fabrixa powiadamia\u0142o Pa\u0144stwa o wszelkich zmianach. Integracja API generuje dwa zdarzenia:<\/p>\n<ul>\n<li><strong>order.created<\/strong> \u2014 uruchamia si\u0119 po przyj\u0119ciu zam\u00f3wienia do realizacji. S\u0142u\u017cy do potwierdzenia odbioru sprzedawcy oraz oznaczenia zam\u00f3wienia jako realizowane.<\/li>\n<li><strong>order.updated<\/strong> \u2014 uruchamia si\u0119 w miar\u0119 przechodzenia zam\u00f3wienia przez kolejne etapy produkcji i wysy\u0142ki, w tym podczas \u015bledzenia przesy\u0142ki. Skorzystaj z tej funkcji, aby zsynchronizowa\u0107 status Pa\u0144stwa platformy bez przekraczania limitu operacji.<\/li>\n<\/ul>\n<p>Bior\u0105c pod uwag\u0119 dwa zdarzenia i limit 30 na minut\u0119, poprawnie dzia\u0142aj\u0105ca integracja ledwo osi\u0105ga ten limit: wysy\u0142amy zlecenie, a nast\u0119pnie reagujemy na otrzyman\u0105 odpowied\u017a.<\/p>\n<h2>Przep\u0142yw zlece\u0144 \u2013 od pocz\u0105tku do ko\u0144ca<\/h2>\n<p>Niezale\u017cnie od tego, kt\u00f3r\u0105 opcj\u0119 wybierzesz, schemat jest taki sam:<\/p>\n<ol>\n<li><strong>Po\u0142\u0105cz si\u0119<\/strong> \u2014 sklep (Shopify lub WooCommerce) albo API.<\/li>\n<li><strong>Projekt<\/strong> \u2014 dostosuj projekt w programie Fabrixa Studio lub dostarcz plik PDF gotowy do druku.<\/li>\n<li><strong>Wy\u015blij zam\u00f3wienie<\/strong> \u2014 za po\u015brednictwem API, wraz z wierszami dotycz\u0105cymi produkt\u00f3w, danymi klienta oraz adresem wysy\u0142ki.<\/li>\n<li><strong>Zajmujemy si\u0119 produkcj\u0105 i wysy\u0142k\u0105<\/strong> \u2014 Fabrixa zajmuje si\u0119 drukowaniem, pakowaniem i wysy\u0142k\u0105 produkt\u00f3w pod mark\u0105 w\u0142asn\u0105.<\/li>\n<\/ol>\n<p>Kr\u00f3tka uwaga na temat jako\u015bci, bo w\u0142a\u015bnie dlatego sprzedawcy wybieraj\u0105 barwniki reaktywne: barwnik reaktywny tworzy wi\u0105zanie kowalencyjne z celuloz\u0105 zawart\u0105 w w\u0142\u00f3knie bawe\u0142nianym i zostaje trwale utrwalony pod wp\u0142ywem ciep\u0142a i pary. Kolor staje si\u0119 cz\u0119\u015bci\u0105 w\u0142\u00f3kna \u2014 nie ma warstwy powierzchniowej, nie p\u0119ka w miejscach zginania \u2014 dzi\u0119ki czemu w dotyku przypomina bawe\u0142n\u0119 bez nadruku i zazwyczaj zachowuje kolor przez ponad 600 cykli prania. Je\u015bli chodzi o przyk\u0142adowy czas realizacji, odzie\u017c produkowana w Portugalii jest gotowa w ci\u0105gu oko\u0142o 6\u20139 dni roboczych.<\/p>\n<h2>Dlaczego platformy opieraj\u0105 si\u0119 na modelu Fabrixa<\/h2>\n<ul>\n<li><strong>MOQ 1<\/strong> \u2014 od jednej sztuki do dziesi\u0105tek tysi\u0119cy. Brak minimalnej wielko\u015bci zam\u00f3wienia, brak op\u0142at za przygotowanie produkcji, brak um\u00f3w.<\/li>\n<li><strong>Domy\u015blnie w wersji white-label<\/strong> \u2014 na ka\u017cdej paczce widnieje marka klienta, a nie nasza.<\/li>\n<li><strong>Kr\u00f3tki \u0142a\u0144cuch dostaw w UE<\/strong> \u2014 transport w obr\u0119bie Portugalii, Hiszpanii i Holandii, a nie transport dalekobie\u017cny.<\/li>\n<li><strong>Prawdziwy druk reaktywny<\/strong> \u2014 Bawe\u0142na organiczna z certyfikatem GOTS jako standardowa podstawa, a tak\u017ce certyfikaty OEKO-TEX Standard 100 i Made in Green.<\/li>\n<\/ul>\n<h2>Najcz\u0119\u015bciej zadawane pytania<\/h2>\n<h3>Czy musz\u0119 korzysta\u0107 z programu Fabrixa Studio, aby m\u00f3c u\u017cywa\u0107 API?<\/h3>\n<p>Nie. Funkcja \u201eStudio\u201d jest opcjonalna. Zamiast tego mo\u017cesz do zam\u00f3wienia do\u0142\u0105czy\u0107 plik PDF gotowy do druku. Z funkcji \u201eStudio\u201d korzystasz tylko wtedy, gdy chcesz, aby kupuj\u0105cy mogli spersonalizowa\u0107 produkt w Pa\u0144stwa sklepie, a projekt ten do\u0142\u0105czasz do zam\u00f3wienia poprzez <code>klucz_pozycji_koszyka<\/code>.<\/p>\n<h3>Jak uwierzytelni\u0107 \u017c\u0105dania?<\/h3>\n<p>Przy ka\u017cdym wywo\u0142aniu wysy\u0142aj dwa nag\u0142\u00f3wki: <code>Autoryzacja: na okaziciela<\/code> oraz <code>X-Application-Key:<\/code>. Oba elementy s\u0105 wymagane \u2014 brak jednego z nich spowoduje odrzucenie wniosku.<\/p>\n<h3>Co si\u0119 stanie, je\u015bli osi\u0105gn\u0119 limit cz\u0119stotliwo\u015bci?<\/h3>\n<p>Limit dla API wynosi 30 \u017c\u0105da\u0144 na minut\u0119. Je\u015bli go przekroczysz, poczekaj chwil\u0119 i spr\u00f3buj ponownie, zamiast nieustannie wysy\u0142a\u0107 \u017c\u0105dania do punktu ko\u0144cowego. W przypadku zmian statusu u\u017cyj <strong>order.created<\/strong> oraz <strong>order.updated<\/strong> webhooki zamiast odpytywania \u2014 zapewniaj\u0105 synchronizacj\u0119 bez zu\u017cywania \u017c\u0105da\u0144.<\/p>\n<h3>Czy realizacja zam\u00f3wie\u0144 to naprawd\u0119 rozwi\u0105zanie typu white label?<\/h3>\n<p>Tak. Przesy\u0142ki s\u0105 wysy\u0142ane pod Pa\u0144stwa mark\u0105, z Pa\u0144stwa adresem zwrotnym, a oznaczenia Fabrixa nie pojawiaj\u0105 si\u0119 w standardzie. Pa\u0144stwa klienci ko\u0144cowi nigdy nas nie widz\u0105.<\/p>\n<h2>Zacznij tworzy\u0107<\/h2>\n<p>Najszybszym sposobem na wej\u015bcie jest <a href=\"\/pl\/programisci\/przewodnik-po-integracji\/\">przewodnik po integracji<\/a>, przy pe\u0142nym wsparciu <a href=\"\/pl\/programisci\/dokumentacja-api\/\">Dokumentacja API<\/a>. Je\u015bli wolisz najpierw zobaczy\u0107, jak to wszystko do siebie pasuje, to <a href=\"\/pl\/platforma\/\">przegl\u0105d platformy<\/a> przechodzi przez kolejne etapy: kana\u0142y, studio, produkcj\u0119 i wysy\u0142k\u0119. A je\u015bli chcesz sprawdzi\u0107, czy rozwi\u0105zanie to pasuje do Pa\u0144stwa platformy, <a href=\"\/pl\/kontakt\/\">skontaktuj si\u0119 z naszym zespo\u0142em<\/a> \u2014 ch\u0119tnie om\u00f3wimy z Pa\u0144stwem Pa\u0144stwa konkretny przypadek zastosowania.<\/p>","protected":false},"excerpt":{"rendered":"<p>Rozwi\u0105zanie integracyjne Fabrixa Integration API umo\u017cliwia platformom i programistom POD pod\u0142\u0105czenie sklepu internetowego, wysy\u0142anie zam\u00f3wie\u0144 i odbieranie webhook\u00f3w \u2014 a nast\u0119pnie drukujemy, pakujemy i wysy\u0142amy produkty pod mark\u0105 w\u0142asn\u0105 za po\u015brednictwem MOQ 1.<\/p>","protected":false},"author":1,"featured_media":312,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[78],"tags":[125,124,123,126,100],"class_list":["post-212","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcements","tag-integration","tag-pod-platform","tag-print-on-demand-api","tag-webhooks","tag-white-label"],"_links":{"self":[{"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/posts\/212","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/comments?post=212"}],"version-history":[{"count":0,"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/posts\/212\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/media\/312"}],"wp:attachment":[{"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/media?parent=212"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/categories?post=212"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.fabrixa.com\/pl\/wp-json\/wp\/v2\/tags?post=212"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}