Fabrixa tisak na zahtjev API omogućuje bilo kojoj POD platformi ili prodajnom mjestu da pošalje narudžbu i prati njezin životni ciklus kroz narudžba.kreirana i order.updated webhooks i Fabrixa ga ispuni, zapakira i pošalje kao white-label — od jednog komada, diljem EU. Vi gradite iskustvo kupnje; mi iza toga pokrećemo reaktivnu proizvodnju tekstila. Nema minimalne narudžbe, nema naknada za postavljanje, nema Fabrixa brendiranja na paketu.
Ovaj je post jednostavan pregled Integration API (v2) na engleskom jeziku za programere koji procjenjuju Fabrixa kao sloj ispunjavanja. Ako umjesto toga želite pregledati referencu, puni API dokumentacija i korak po korak Vodič za integraciju Spremni smo kad vi budete.
Čemu služi API
Fabrixa je reaktivna platforma za tisak na tekstiluJedna nadzorna ploča za prodajne kanale, dizajne, proizvodnju i otpremu. Većina kupaca se povezuje putem Shopifyja, WooCommercea ili Fabrixa Studija. Integracija API je četvrti put — izgrađena za POD platforme i programere koji već posjeduju svoju trgovinu i žele programsku kontrolu nad ispunjenjem narudžbi.
Vi zovete API da pošalje narudžbe. Fabrixa ih proizvodi: reaktivni tisak na pamuku i lanu u Portugalu i Španjolskoj, sublimacija na poliesteru u Nizozemskoj. Paketi se šalju pod vašim brendom, s vašom adresom za povrat, i bez ikakvih oznaka Fabrixa na paketu. Vaši kupci nikada neće saznati da postojimo, osim ako im ne kažete.
Što API radi
- Ping — lagana provjera zdravlja za potvrdu da su vaše vjerodajnice i veza aktivni prije nego što pošaljete bilo što stvarno.
- Proizvodi — pogledajte katalog na kojem se temeljite: odjeća, kućni tekstil i tkanina na metar, s osnovama i varijantama dostupnima za tisak.
- Narudžbe — stvorite narudžbu i pročitajte njezino stanje. To je srž svake integracije: redovi, izvori, podaci o kupcu i dostavi ulaze; vraća se narudžba s praćenjem.
- Ispunjenja — pratite proizvodnju i otpremu kako se artikli izrađuju i šalju, kako bi vaša platforma mogla prodavačima prikazati točan status.
- Studio — priložite personalizirani dizajn u Fabrixa Studio (naš ugradivi, white-label prilagođivač proizvoda) u narudžbu prema njezinoj
ključ_košarice, pa ono što kupac dizajnira točno se i ispisuje.
Autentifikacija i ograničenja brzine
Integracija API (v2) nalazi se na baznoj URL adresi. https://api.fabrixa.com/v2/integration. Svaki zahtjev nosi dva zaglavlja:
| Naslov | Svrha |
|---|---|
Autorizacija: nositelj |
Vaš API token — identificira i autorizira zahtjev. |
X-Application-Key: |
Ključ vaše aplikacije — uparuje se s tokenom, pa oba moraju biti prisutna. |
Ograničenje brzine je 30 zahtjeva u minuti. To je dovoljno za promet vođen narudžbama, ali to znači da se velike operacije trebaju odvijati tempom, a ne izvršavati u kratkom ciklusu. Prilagodite se ograničenju na elegantan način, povucite se kad ga dosegnete i oslonite se na webhooke (dolje) umjesto na polling.
Webhooks: reagirajte na stanje, ne provjeravajte ga
Umjesto da stalno postavljate pitanje “je li već gotovo?”, pretplatite se na webhooke i dopustite Fabrixa da vas obavijesti kad se nešto promijeni. Integracija API emitira dva događaja:
- narudžba.kreirana — pokreće se kada se narudžba prihvati u proizvodnju. Koristite ga za potvrdu primitka prodavaču i označavanje narudžbe kao u obradi.
- order.updated — pozivi se upućuju dok se nalog obrađuje u proizvodnji i otpremi, uključujući praćenje. Koristite ga za sinkronizaciju statusa vaše platforme bez prekoračenja ograničenja brzine.
Između dva događaja i ograničenja od 30 po minuti, dobro ponašajuća integracija jedva dotiče granicu: pošalji nalog, a zatim reagiraj na ono što se vrati.
Protok naloga, od početka do kraja
Koji god put odaberete, oblik je isti:
- Poveži se — trgovina (Shopify ili WooCommerce) ili API.
- Dizajn — personalizirajte u Fabrixa Studiju ili dostavite PDF spreman za tisak.
- Pošalji narudžbu — putem API-a, s redovima proizvoda, adresom kupca i adresom za dostavu.
- Proizvodimo i šaljemo — Fabrixa tiskati, pakirati i slati, white-label.
Kratka napomena o kvaliteti, jer je to razlog zašto prodavači biraju reaktivne boje: reaktivna boja stvara kovalentnu vezu s celulozom u vlaknu pamuka i trajno se fiksira pod utjecajem topline i pare. Boja postaje dio vlakna — nema površinskog sloja, nema pucanja na savojnim točkama — pa se osjeća kao neotisnuti pamuk i obično zadržava boju u više od 600 ciklusa pranja. Kao primjer vremena isporuke, odjeća proizvedena u Portugalu traje otprilike 6–9 radnih dana.
Zašto platforme grade na Fabrixa
- MOQ 1 — od jednog komada do desetaka tisuća. Nema minimalne narudžbe, nema naknada za postavljanje, nema ugovora.
- White-label prema zadanim postavkama — brend kupca na svakoj pošiljci, a ne naš.
- Kratki lanac opskrbe EU — proizvodnja diljem Portugala, Španjolske i Nizozemske, a ne dugoprugni teretni promet.
- Stvarni reaktivni ispis — Organski pamuk s GOTS certifikatom kao standardna osnova za odjeću, uz OEKO-TEX Standard 100 i Made in Green.
Često postavljana pitanja
Moram li koristiti Fabrixa Studio da bih koristio API?
Ne. Studio je neobavezan. Umjesto toga možete poslati PDF spreman za tisak uz narudžbu. Studio se koristi samo kada želite da kupci personaliziraju proizvod u vašoj trgovini i kada taj dizajn priložite narudžbi pomoću ključ_košarice.
Kako mogu autentificirati zahtjeve?
Pošaljite dva zaglavlja pri svakom pozivu: Autorizacija: nositelj i X-Application-Key:. Oba su potrebna zajedno — jedno bez drugog bit će odbijeno.
Što se događa ako dosegnem ograničenje stope?
API je ograničen na 30 zahtjeva u minuti. Ako to prekoračite, odmaknite se i pokušajte ponovno umjesto da zatrpavate krajnju točku. Za promjene statusa koristite narudžba.kreirana i order.updated webhooks umjesto pollinga — održavaju vas sinkroniziranima bez trošenja zahtjeva.
Je li ispunjenje zaista white-label?
Da. Pošiljke se šalju pod vašim brendom, s vašom adresom za povrat i standardno bez Fabrixa brendiranja. Vaši krajnji kupci nas nikada ne vide.
Počni graditi
Najbrži put ulaska je Vodič za integraciju, uz potporu cijele API dokumentacija. Ako biste radije prvo vidjeti kako se sve uklapa, Pregled platforme prolazi kroz kanale, studio, produkciju i distribuciju. A ako želite testirati prikladnost za svoju platformu pod pritiskom, Obratite se našem timu — rado ćemo proći kroz vaš slučaj upotrebe.
