A Fabrixa „print on demand” API megoldás lehetővé teszi bármely POD platform vagy webáruház számára, hogy megrendelést küldjön, és nyomon kövesse annak teljes életciklusát order.created és order.updated webhookok segítségével, és a Fabrixa gondoskodik a nyomtatásról, csomagolásról és a fehér címkés kiszállításról – akár egyetlen darabtól kezdve, az egész EU-ban. Ön alakítja ki a vásárlási élményt; mi pedig a háttérben gondoskodunk a rugalmas textilgyártásról. Nincs minimális rendelési mennyiség, nincs beállítási díj, és a csomagon nem szerepel a Fabrixa márkajelzés.
Ez a bejegyzés az Integration API (v2) egyszerű, érthető nyelven írt áttekintése azoknak a fejlesztőknek, akik az Fabrixa-t teljesítési rétegként értékelik. Ha inkább át szeretnéd futni a referenciaanyagot, a teljes API dokumentáció és lépésről lépésre bevezetési útmutató akkor állunk készen, amikor te is.
Mire szolgál az API?
Az Fabrixa egy reaktív textilnyomtatási platform: egyetlen irányítópult az értékesítési csatornák, a tervezés, a gyártás és a kiszállítás kezeléséhez. A legtöbb ügyfél a Shopify, a WooCommerce vagy az Fabrixa Studio szolgáltatáson keresztül csatlakozik. Az API integráció a negyedik lehetőség — az POD platformok és azok a fejlesztők számára készült, akik már rendelkeznek saját webáruházzal, és programozási szinten szeretnék irányítani a rendelések teljesítését.
A megrendeléseket az API-hez intézi. Az Fabrixa pedig gyártja azokat: reaktív nyomtatás pamutra és lenre Portugáliában és Spanyolországban, szublimációs nyomtatás poliészterre Hollandiában. A csomagokat az Ön márkaneve alatt, az Ön visszaküldési címével szállítjuk, és a csomagokon sehol nem szerepel az Fabrixa jelölése. Az ügyfelei soha nem tudják meg, hogy létezünk, hacsak Ön nem mondja el nekik.
A API működése
- Ping — egy egyszerű állapotellenőrzés, amely meggyőződik arról, hogy a hitelesítő adataid és a kapcsolatod működnek-e, mielőtt bármilyen tényleges adatot elküldesz.
- Termékek — olvassa el azt a katalógust, amelyre épít: ruházat, lakástextilek és méteráru szövetek, a nyomtatásra alkalmas alapváltozatokkal és változatokkal együtt.
- Megrendelések — megrendelés létrehozása és állapotának lekérdezése. Ez minden integráció lényege: a rendszerbe bekerülnek a sorok, a források, az ügyfél- és szállítási adatok, és cserébe egy nyomon követhető megrendelés kerül vissza.
- Teljesítések — kövesse nyomon a gyártást és a kiszállítást a termékek elkészülte és feladása során, így a platformja pontos állapotinformációkat tud nyújtani az eladóknak.
- Stúdió — csatoljon egy személyre szabott tervet Fabrixa Studio (a beágyazható, saját márkás termékkonfigurátorunkat) egy megrendeléshez annak
kosár_tétel_kulcs, így pontosan az lesz kinyomtatva, amit a vásárló megtervezett.
Hitelesítés és forgalomkorlátozás
Az Integration API (v2) az alap-URL-en található https://api.fabrixa.com/v2/integration. Minden kérés tartalmaz két fejléc:
| Fejléc | Cél |
|---|---|
Jogosultság: Bírósági |
Az API tokenje – azonosítja és hitelesíti a kérést. |
X-Application-Key: |
Az alkalmazáskulcsod — a tokennel párosul, ezért mindkettőnek jelen kell lennie. |
A sebességkorlátozás 30 kérés percenként. Ez bőven elegendő a megrendelésalapú forgalomhoz, de azt jelenti, hogy a tömeges műveleteket nem szűk ciklusban kell végrehajtani, hanem fokozatosan. Kezelje a korlátot megfelelően: ha eléri, álljon le, és a lekérdezés helyett inkább a webhookokat (lásd alább) használja.
Webhookok: reagálj az állapotra, ne kérdezd le azt
Ahelyett, hogy folyton azt kérdeznéd: “Kész van már?”, iratkozz fel a webhookokra, és hagyd, hogy az Fabrixa értesítsen, ha valami megváltozik. Az API integráció két eseményt generál:
- order.created — akkor aktiválódik, amikor egy megrendelést gyártásra átvesznek. Használd arra, hogy visszaigazold az átvételt az eladónak, és a megrendelést „folyamatban lévő” státuszra állítsd.
- order.updated — értesítéseket küld, ahogy a megrendelés halad a gyártáson és a kiszállításon keresztül, beleértve a nyomon követést is. Használd ezt arra, hogy a platformod állapotát naprakészen tartsd anélkül, hogy kimerítenéd a kéréskorlátodat.
Két esemény között és egy percenkénti 30-as felső határ mellett egy megfelelően működő integráció alig éri el a határt: küldd el a parancsot, majd reagálj a visszajelzésre.
A megbízásáramlás teljes folyamata
Bármelyik útvonalat is választod, az alakja ugyanaz:
- Csatlakozás — egy webáruház (Shopify vagy WooCommerce) vagy a API.
- Tervezés — személyre szabhatja a Fabrixa Studio-ban, vagy beküldhet egy nyomtatásra kész PDF-fájlt.
- A megrendelés elküldése — az API-n keresztül, a termékadatokkal, az ügyfél- és a szállítási címmel együtt.
- Gyártunk és kiszállítunk — A Fabrixa nyomtat, csomagol és szállít, saját márkanév alatt.
Egy rövid megjegyzés a minőségről, hiszen ez az oka annak, hogy az eladók a reaktív festéket választják: a reaktív festék kovalens kötést alakít ki a pamutszál cellulózával, és hő és gőz hatására tartósan rögzül. A szín a szál részévé válik – nincs felületi réteg, nincs repedés a hajlítási pontokon –, így tapintásra olyan, mint a nyomtatás nélküli pamut, és általában több mint 600 mosási cikluson át megőrzi a színét. Példaként említhetjük, hogy a Portugáliában gyártott ruházati cikkek szállítási ideje körülbelül 6–9 munkanap.
Miért épülnek a platformok a Fabrixa-re?
- MOQ 1 — egy darabtól több tízezerig. Nincs minimális rendelési mennyiség, nincs beállítási díj, nincs szerződés.
- Alapértelmezés szerint fehér címkés — minden csomagon az ügyfél márkajele szerepel, nem a miénk.
- Rövid uniós ellátási lánc — Portugáliában, Spanyolországban és Hollandiában zajló gyártás, nem pedig távolsági árufuvarozás.
- Valódi reaktív nyomtatás — A ruházati termékek alapanyagaként alapértelmezés szerint GOTS-tanúsítvánnyal rendelkező ökológiai pamutot használunk, emellett az OEKO-TEX Standard 100 és a Made in Green tanúsítványok is érvényesek.
GYIK
Szükségem van a Fabrixa Studio használatára ahhoz, hogy a API-t használhassam?
Nem. A Studio használata nem kötelező. A megrendeléshez helyette elküldhetsz egy nyomtatásra kész PDF-fájlt is. A Studio csak akkor kerül képbe, ha azt szeretnéd, hogy a vásárlók személyre szabhassák a terméket a webáruházadban, és ezt a tervet a megrendeléshez csatolod azáltal, hogy kosár_tétel_kulcs.
Hogyan hitelesíthetem a kéréseket?
Minden híváskor küldj el két fejlécet: Jogosultság: Bírósági és X-Application-Key:. Mindkettőre szükség van – ha az egyik hiányzik, a kérelmet elutasítják.
Mi történik, ha eléröm a kéréskorlátot?
Az API percenkénti 30 kérésre van korlátozva. Ha túllépi ezt a határt, ne bombázza az végpontot, hanem várjon egy kicsit, majd próbálja meg újra. Állapotváltozások esetén használja a order.created és order.updated webhookok a lekérdezés helyett — így mindig naprakészek maradsz, anélkül, hogy kéréseket pazarolnál.
A teljesítés valóban „white-label” jellegű?
Igen. A csomagokat alapértelmezés szerint az Ön márkaneve alatt, az Ön visszaküldési címével szállítjuk, és a Fabrixa márkajelzés nem szerepel rajtuk. A végfelhasználók soha nem látnak minket.
Kezdje el az építést!
A leggyorsabb út bejutni a bevezetési útmutató, amelynek teljes támogatását élvezi API dokumentáció. Ha inkább először szeretnéd megnézni, hogyan illeszkedik össze az egész, akkor a a platform áttekintése átfut a csatornákon, a stúdión, a gyártáson és a kiszállításon. És ha szeretnéd kipróbálni, hogy ez illeszkedik-e a platformodhoz, vegye fel a kapcsolatot csapatunkkal — szívesen áttekintjük az Ön felhasználási esetét.
