Rešitev Fabrixa za tiskanje na zahtevo API omogoča vsaki platformi ali spletni trgovini POD, da odda naročilo in spremlja njegov življenjski cikel skozi order.created in order.updated webhooki, Fabrixa pa poskrbi za tiskanje, pakiranje in pošiljanje pod vašo blagovno znamko – že od enega kosa, po vsej EU. Vi oblikujete nakupno izkušnjo; mi pa v ozadju skrbimo za prožno tekstilno proizvodnjo. Brez minimalnega naročila, brez nastavitvenih stroškov, brez logotipa Fabrixa na pošiljki.
Ta prispevek je pregled integracije API (v2) v preprostem jeziku, namenjen razvijalcem, ki preučujejo Fabrixa kot izvedbeno plast. Če pa želite raje na hitro preleteti referenčni dokument, je celoten Dokumentacija za API in korak za korakom vodnik po integraciji smo pripravljeni, ko boste vi.
Za kaj se uporablja API
Fabrixa je platforma za reaktivni tekstilni tisk: en nadzorni panel za prodajne kanale, oblikovanje, proizvodnjo in odpremo. Večina strank se poveže prek Shopifyja, WooCommercea ali Fabrixa Studia. Integracija API je četrta možnost – zasnovana za platforme POD in razvijalce, ki že imajo svojo spletno trgovino in želijo programski nadzor nad izpolnjevanjem naročil.
Za oddajo naročil pokličete podjetje API. Podjetje Fabrixa jih izvede: reaktivni tisk na bombaž in lan v Portugalski in Španiji ter sublimacijski tisk na poliester na Nizozemskem. Paketi se pošiljajo pod vašo blagovno znamko, z vašim naslovom pošiljatelja, na paketu pa ni nikjer vidnih oznak podjetja Fabrixa. Vaši kupci nikoli ne izvejo za naš obstoj, razen če jim to sami poveste.
Kaj počne API
- Ping — preprost preizkus delovanja, s katerim preverite, ali so vaši prijavni podatki veljavni in ali je povezava vzpostavljena, preden pošljete kakršne koli dejanske podatke.
- Izdelki — preberite katalog, na katerem temelji vaša ponudba: oblačila, tekstil za dom in tkanine po metrih, skupaj z osnovnimi modeli in različicami, ki so na voljo za tiskanje.
- Naročila — ustvarjanje naročila in preverjanje njegovega stanja. To je bistvo vsake integracije: vnesemo vrstice, vire, podatke o stranki in pošiljki; v zameno dobimo naročilo s sledljivostjo.
- Izpolnitve — spremljajte proizvodnjo in odpremo, ko se izdelki izdelujejo in odpremljajo, tako da vaša platforma prodajalcem prikazuje natančen status.
- Studio — priložite osebno prilagojeno zasnovo v Fabrixa Studio (naš vgradljiv orodje za prilagajanje izdelkov z možnostjo »white label«) k naročilu po njegovem
cart_item_key, tako da se natisne natanko tisto, kar je kupec zasnoval.
Preverjanje pristnosti in omejitve števila zahtevkov
Integracija API (v2) se nahaja na osnovnem URL-ju https://api.fabrixa.com/v2/integration. Vsaka zahteva vsebuje dva naslova:
| Naslov | Namen |
|---|---|
Pooblastilo: nosilec |
Vaš žeton API — identificira in avtorizira zahtevo. |
X-Application-Key: |
Vaš ključ aplikacije — je povezan s tokenom, zato morata biti oba prisotna. |
Omejitev števila zahtevkov je 30 zahtevkov na minuto. To je dovolj za promet, ki ga poganjajo naročila, vendar pomeni, da je treba množične operacije izvajati postopoma, namesto da bi jih izvajali v kratkem ciklu. Omejitev obravnavajte na primeren način, umaknite se, ko jo dosežete, in namesto rednega poizvedovanja raje uporabljajte webhooke (spodaj).
Webhooki: odzivajte se na stanje, ne ga pa redno preverjajte
Namesto da vedno znova sprašujete “Ali je že končano?”, se naročite na webhooke in pustite, da vas Fabrixa obvesti, ko pride do sprememb. Integracija API sproži dva dogodka:
- order.created — se sproži, ko je naročilo sprejeto v proizvodnjo. Uporabite ga, da prodajalcu potrdite prejem in naročilo označite kot v obdelavi.
- order.updated — sproži se, ko naročilo poteka skozi proizvodnjo in odpremo, vključno s sledenjem. Uporabite ga, da boste ohranili sinhronizacijo stanja vaše platforme, ne da bi prekoračili omejitev števila zahtevkov.
Med dvema dogodkoma in zgornjo mejo 30 na minuto se pravilno izvedena integracija komaj dotakne te meje: pošlji ukaz, nato pa se odzovi na prejeti odgovor.
Potek naročila, od začetka do konca
Ne glede na to, katero pot izberete, je oblika enaka:
- Poveži se — spletna trgovina (Shopify ali WooCommerce) ali API.
- Oblikovanje — prilagodite v programu Fabrixa Studio ali nam pošljite PDF, pripravljen za tisk.
- Pošlji naročilo — prek API, z vrsticami izdelkov, strankami in naslovi za dostavo.
- Proizvajamo in odpremljamo — Fabrixa skrbi za tiskanje, pakiranje in pošiljanje pod lastno blagovno znamko.
Kratka opomba o kakovosti, saj je prav to razlog, zakaj se prodajalci odločajo za reaktivno barvanje: reaktivno barvilo tvori kovalentno vez s celulozo v bombažnih vlaknih in se pod vplivom toplote in pare trajno fiksira. Barva postane del vlakna – ni površinskega sloja, ni razpok na mestih upogibanja –, zato se na otip zdi kot netiskani bombaž, barva pa običajno ostane nespremenjena več kot 600 pralnih ciklov. Kot primer dobavnega roka: oblačila, izdelana na Portugalskem, so pripravljena v približno 6–9 delovnih dneh.
Zakaj platforme temeljijo na principu Fabrixa
- MOQ 1 — od enega kosa do deset tisoč. Brez minimalnega naročila, brez stroškov priprave, brez pogodb.
- Privzeto v obliki »white-label« — na vsakem paketu je navedena blagovna znamka stranke, ne naša.
- Kratka dobavna veriga v EU — prevoz po Portugalski, Španiji in Nizozemski, ne pa tovorni prevoz na dolge razdalje.
- Resnično reaktivni tisk — Ekološki bombaž s certifikatom GOTS kot osnovni material za oblačila, poleg tega pa še certifikata OEKO-TEX Standard 100 in Made in Green.
Pogosta vprašanja
Ali moram za uporabo API uporabljati program Fabrixa Studio?
Ne. Studio ni obvezen. Namesto tega lahko skupaj z naročilom pošljete PDF, pripravljen za tisk. Studio pride v poštev le, če želite, da kupci v vaši spletni trgovini prilagodijo izdelek po lastnih željah, in ta dizajn priložite naročilu tako, da cart_item_key.
Kako avtentificiram zahteve?
Pri vsakem klicu pošlji dva glava: Pooblastilo: nosilec in X-Application-Key:. Oboje je obvezno – če enega od njiju manjka, bo vloga zavrnjena.
Kaj se zgodi, če dosežem omejitev števila poizkusov?
API omejuje število zahtevkov na 30 na minuto. Če to število presežete, počakajte in poskusite znova, namesto da neprestano pošiljate zahtevke na končno točko. Za spremembe stanja uporabite order.created in order.updated webhooki namesto rednega poizvedovanja — omogočajo sinhronizacijo brez porabe zahtevkov.
Ali gre pri izpolnjevanju naročil res za rešitev »white-label«?
Da. Paketi se standardno pošiljajo pod vašo blagovno znamko z vašim naslovom pošiljatelja, brez oznake Fabrixa. Vaši končni kupci nas nikoli ne vidijo.
Začnite graditi
Najhitrejši način za vstop je vodnik po integraciji, ob polni podpori Dokumentacija za API. Če bi raje najprej videli, kako se vse skupaj ujema, potem pregled platforme poteka skozi kanale, studio, produkcijo in odpošiljanje. Če pa želite preizkusiti, ali je rešitev primerna za vašo platformo, pogovorite se z našo ekipo — z veseljem bomo z vami pregledali vaš primer uporabe.
