Služba Fabrixa „print on demand“ API umožňuje akejkoľvek platforme alebo internetovému obchodu POD odoslať objednávku a sledovať jej životný cyklus prostredníctvom order.created a order.updated webhooky a nechajte spoločnosť Fabrixa vytlačiť, zabaliť a odoslať to pod vašou značkou – už od jedného kusu, a to po celej EÚ. Vy vytvárate nákupný zážitok; my za tým zabezpečujeme flexibilnú textilnú výrobu. Žiadna minimálna objednávka, žiadne poplatky za zriadenie, žiadne označenie Fabrixa na balíku.
Tento príspevok je prehľadom integrácie API (v2) napísaným zrozumiteľným jazykom pre vývojárov, ktorí zvažujú použitie Fabrixa ako vrstvy na spracovanie objednávok. Ak si chcete skôr prečítať referenčný dokument, úplné znenie Dokumentácia k API a krok za krokom príručka na integráciu sme pripravení, keď budete vy.
Na čo slúži API
Fabrixa je platforma pre reaktívnu textilnú potlač: jeden riadiaci panel pre predajné kanály, dizajny, výrobu a expedíciu. Väčšina zákazníkov sa pripája prostredníctvom Shopify, WooCommerce alebo Fabrixa Studio. Integrácia API predstavuje štvrtú možnosť – je určená pre platformy POD a vývojárov, ktorí už vlastnia svoj internetový obchod a chcú programovo riadiť proces vybavovania objednávok.
Na odosielanie objednávok kontaktujete spoločnosť API. Spoločnosť Fabrixa ich vyrába: reaktívna potlač na bavlne a ľane v Portugalsku a Španielsku, sublimačná potlač na polyesteri v Holandsku. Balíky sa odosielajú pod vašou značkou, s vašou spätnou adresou a bez akýchkoľvek označení spoločnosti Fabrixa na obale. Vaši zákazníci sa nikdy nedozvedia o našej existencii, pokiaľ im to sami nepoviete.
Čo robí API
- Ping — jednoduchá kontrola funkčnosti, ktorá overí, či sú vaše prihlasovacie údaje a pripojenie v poriadku, skôr než odošlete akékoľvek skutočné údaje.
- Produkty — prečítajte si katalóg, na ktorom pracujete: oblečenie, bytový textil a metráž, vrátane základných modelov a variantov určených na potlač.
- Objednávky — vytvoriť objednávku a zistiť jej stav. To je základ každej integrácie: zadajú sa riadky, zdroje, údaje o zákazníkovi a doručení; výsledkom je sledovaná objednávka.
- Plnenia — sledujte výrobu a expedíciu v priebehu výroby a odosielania tovaru, aby vaša platforma mohla predajcom poskytovať presné informácie o stave objednávok.
- Štúdio — priložte personalizovaný návrh v Fabrixa Studio (náš nástroj na prispôsobenie produktov, ktorý je možné vložiť a používať pod vlastnou značkou) k objednávke podľa jej
kľúč položky v košíku, takže to, čo navrhol kupujúci, sa presne tak aj vytlačí.
Overovanie a obmedzenia frekvencie
Integrácia API (v2) sa nachádza na základnej URL adrese https://api.fabrixa.com/v2/integration. Každá požiadavka obsahuje dve hlavičky:
| Nadpis | Účel |
|---|---|
Autorizácia: Na predloženie |
Váš token API – identifikuje a autorizuje žiadosť. |
X-Application-Key: |
Kľúč vašej aplikácie – tvorí pár s tokenom, takže musia byť prítomné obidva. |
Limit frekvencie je 30 požiadaviek za minútu. To je dostatočné pre návštevnosť generovanú objednávkami, znamená to však, že hromadné operácie by sa mali vykonávať postupne, a nie v krátkych intervaloch. S týmto obmedzením narábajte citlivo – keď ho dosiahnete, spomaľte a namiesto opakovaného dotazovania sa spoliehajte na webhooky (pozri nižšie).
Webhooky: reagujte na stav, nepreverujte ho
Namiesto toho, aby ste sa neustále pýtali “už je to hotové?”, prihláste sa na odber webhookov a nechajte Fabrixa, aby vás informovalo, keď sa niečo zmení. Integrácia API vysiela dve udalosti:
- order.created — aktivuje sa pri prijatí objednávky do výroby. Použite ju na potvrdenie prijatia predajcovi a na označenie objednávky ako spracovávanej.
- order.updated — spúšťa sa v priebehu celého procesu výroby a expedície, vrátane sledovania. Využite túto funkciu na synchronizáciu stavu vašej platformy bez toho, aby ste prekročili limit počtu požiadaviek.
Pri dvoch udalostiach a limite 30 za minútu sa správne navrhnutá integrácia tohto limitu takmer nedotkne: najprv odošlite príkaz a potom reagujte na spätnú odpoveď.
Priebeh objednávky od začiatku do konca
Nech už si vyberiete akúkoľvek trasu, priebeh je rovnaký:
- Pripojiť sa — internetový obchod (Shopify alebo WooCommerce) alebo API.
- Dizajn — prispôsobte si ho v programe Fabrixa Studio alebo nám poskytnite PDF súbor pripravený na tlač.
- Odoslať objednávku — prostredníctvom API, s riadkami produktov, zákazníkom a dodacou adresou.
- Vyrábame a expedujeme — Spoločnosť Fabrixa zabezpečuje tlač, balenie a expedíciu v rámci služby „white-label“.
Stručná poznámka o kvalite, pretože práve kvôli nej si predajcovia vyberajú reaktívne farbenie: reaktívne farbivo vytvára kovalentnú väzbu s celulózou v bavlnenom vlákne a pri pôsobení tepla a pary sa trvalo zafixuje. Farba sa stáva súčasťou vlákna – bez povrchovej vrstvy, bez praskania v miestach ohybu – takže na dotyk pôsobí ako nepotlačená bavlna a farba zvyčajne vydrží viac ako 600 pracích cyklov. Ako príklad dodacej lehoty uvádzame, že výroba odevov v Portugalsku trvá približne 6–9 pracovných dní.
Prečo platformy využívajú Fabrixa
- MOQ 1 — od jedného kusu až po desaťtisíce. Žiadna minimálna objednávka, žiadne poplatky za prípravu, žiadne zmluvy.
- Štandardne ako white-label — na každej zásielke je značka zákazníka, nie naša.
- Krátky dodávateľský reťazec v EÚ — preprava v rámci Portugalska, Španielska a Holandska, nie diaľková nákladná preprava.
- Skutočná reaktívna tlač — Organická bavlna s certifikátom GOTS ako štandardný základ pre odevné výrobky, a navyše certifikáty OEKO-TEX Standard 100 a Made in Green.
Často kladené otázky
Musím používať program Fabrixa Studio, aby som mohol používať API?
Nie. Funkcia „Studio“ je voliteľná. Namiesto toho môžete k objednávke priložiť PDF súbor pripravený na tlač. Funkcia „Studio“ prichádza do úvahy len vtedy, ak chcete, aby si kupujúci mohli produkt vo vašom obchode prispôsobiť, a tento návrh pripojíte k objednávke tak, že kľúč položky v košíku.
Ako overím žiadosti?
Pri každom volaní odošlite dve hlavičky: Autorizácia: Na predloženie a X-Application-Key:. Obe sú potrebné – ak chýba jedna z nich, žiadosť bude zamietnutá.
Čo sa stane, ak dosiahnem limit počtu požiadaviek?
Limit API je 30 požiadaviek za minútu. Ak tento limit prekročíte, počkajte a skúste to znovu, namiesto toho, aby ste koncový bod neustále bombardovali požiadavkami. Pri zmenách stavu použite order.created a order.updated webhooky namiesto opakovaného dotazovania — zabezpečujú synchronizáciu bez spotrebovania požiadaviek.
Je táto služba naozaj typu „white-label“?
Áno. Balíky sa štandardne odosielajú pod vašou značkou s vašou spätnou adresou a bez akéhokoľvek označenia Fabrixa. Vaši koneční zákazníci nás nikdy neuvidia.
Začnite stavať
Najrýchlejší spôsob, ako sa tam dostať, je príručka na integráciu, s plnou podporou Dokumentácia k API. Ak by ste si najskôr chceli pozrieť, ako to celé do seba zapadá, tak prehľad platformy prechádza jednotlivými kanálmi – štúdiom, produkciou a expedíciou. A ak by ste chceli otestovať, či je to vhodné pre vašu platformu, porozprávajte sa s naším tímom — radi s vami prejdeme váš konkrétny prípad použitia.
