Dva načina za slanje narudžbi na Fabrixa: povežite trgovinu koju već vodite — Shopify ili WooCommerce — bez koda, ili izgradite izravno na integraciji API. Ovaj vodič pokriva oboje: povežite prodajni kanal u nekoliko minuta ili od autorizacije do ispunjenja narudžbe za petnaest minuta.
Većina trgovina nikada ne dira API. Dodajte Fabrixa kao prodajni kanal i narudžbe iz vaše trgovine teče ravno u proizvodnju — proizvodi su sinkronizirani, statusi vraćeni, nema koda za pisanje ni održavanje. Ruta API dalje dolje namijenjena je prilagođenim trgovinama i POD platformama.
Na svojoj nadzornoj ploči otvorite Create channel i odaberite vrstu integracije. Svaki kanal vodi vlastite proizvode, uvezene narudžbe i pravila uvoza — povežite ih koliko god ih imate.
Nema ključeva za kopiranje. Autorizirajte Fabrixa u svom Shopify administracijskom sučelju i veza je aktivna.
Create channel, odaberi Shopify.WordPress trgovina povezuje se pomoću REST ključa za čitanje/pisanje — generiranog u WooCommerceu i jednom zalijepljenog u Fabrixa.
Settings → Advanced → REST API → Add key s Čitaj/Piši ovlasti.ck_ ključ, cs_ tajnu i domenu vaše trgovine unesite u Fabrixa.Prodajete li prilagođene proizvode? Fabrixa Studio — uređivač dizajna white-label — dostupan je i u trgovinama na Shopifyju i WooCommerceu, tako da vaši kupci personaliziraju proizvode pod vašim brendom. Pogledajte Fabrixa Studio →
Povezane trgovine nalaze se uz vaše API i partnerske kanale u prikazu Kanali — sinkronizirani proizvodi, primljene narudžbe, posljednja uvožena referenca i prihod po kanalu. Prebacite kanal iz nacrta u aktivno stanje kad ste spremni; ništa nizvodno se ne mijenja.
Izgraditi prilagođenu trgovinu ili vlastitu POD platformu umjesto toga? Ostatak ovog vodiča je API put — od autentifikacije do ispunjenja u četiri koraka.
Tri stvari vas dovode od nule do aktivne narudžbe. Sve se one izdaju s vaše Fabrixa nadzorne ploče ili od vašeg inženjera za rješenja.
Token za pristup aplikaciji i ključ aplikacije. Oba su potrebna u svakom zahtjevu — token u zaglavlju Authorization, ključ u zaglavlju X-Application-Key. U svom nadzornom ploči stvorite prodajni kanal kako biste ih odmah generirali — nije potreban nikakav zahtjev.
Javno dostupna HTTPS krajnja točka koja prihvaća JSON POST zahtjeve. Localhost u razvoju radi putem tunela. Provjeravate HMAC-SHA256 potpis na svakoj pošiljci prije obrade.
Vaša datoteka s umjetničkim djelom — PDF, TIFF, JPG ili PNG — dostupna putem HTTPS-a bez autentifikacije. RGB boja, do 50 MB i 15.000 px po strani. PDF-ovi s više stranica imaju jednu stranicu po sloju. Preuzimamo datoteku i izrađujemo ispravne datoteke za tisak kad renderiramo posao.
Svaki zahtjev se šalje na baznu URL adresu. https://api.fabrixa.com/v2/integration s oba naslova postavljena. GET /ping Potvrđuje da su token i ključ valjani prije nego što učinite išta drugo.
Status 401 znači da nedostaje zaglavlje ili je token opozvan. Status 403 znači da su vjerodajnice valjane, ali im nedostaje dopuštenje za resurs.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
Katalog vraća varijante proizvoda s njihovim SKU i variant_id. Svaki odgovor na popis je omotan u standardni links / meta / data omota, pa stranice označite s next_page link. Pohrani lokalno — katalog nije po zahtjevu.
Detalj cijelog polja nalazi se u Referenca na stav.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Pošalji rows (SKU + količina + izvorni PDF), customer i shipping_address. Postavite svoje number kao referencu — izostavite je i mi ćemo je generirati. Pohranite vraćeni Fabrixa ID narudžbe uz svoju narudžbu.
Studio naredbe zamjenjuju sources podnijeti kod cart_item_key od spremljenog dizajna; sve ostalo je identično.
POST /v2/integration/orders
{
"number": "ORD-2026-0142",
"purchased_at": "2026-05-28 14:22:01",
"rows": [
{
"sku": "COF099191",
"quantity": 1,
"sources": [
{ "type": "file", "url": "https://cdn.you.com/art/9812.pdf" }
]
}
],
"customer": {
"first_name": "Maria", "last_name": "Silva",
"email": "maria@example.com", "phone": "+351912345678"
},
"shipping_address": {
"address": "Rua do Carmo 42", "city": "Lisboa",
"postal_code": "1200-094",
"country_code": "PT", "country": "Portugal"
}
}
Postavite URL webhooka na nadzornoj ploči. Mi POST-amo. order.created i order.updated to to s punim tijelom reda, an x-webhook-signature (HMAC-SHA256) i jedan x-webhook-topic Zaglavlje. Provjeri potpis, vrati 200 brzo, obrađujte asinkrono.
Svaki događaj i isječci za provjeru nalaze se na Referenca za webhookove.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Greške se vraćaju kao JSON, nikada HTML. The errors.messages array names what failed; na 400-kodu greške navodi polja koja nisu prošla validaciju.
Greška pri validaciji, nedostajuće ili opozvane vjerodajnice, nedovoljna dozvola ili nepoznati resurs.
30 zahtjeva po aplikaciji u minuti. X-RateLimit-Limit i X-RateLimit-Remaining nalaze se u svakom odgovoru.
Na strani poslužitelja. Ponovite pokušaj s odgađanjem; ako se problem nastavi, pošaljite ID zahtjeva svom inženjeru za rješenja.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa dopušta 30 zahtjeva po aplikaciji u minuti; prekoračenje toga vraća odgovor 429 Previše zahtjeva. Zaglavlja X-RateLimit-Limit i X-RateLimit-Remaining uključena su u svaki odgovor kako bi integracija mogla pratiti preostalu kvotu prije dosezanja ograničenja.
Fabrixa prihvaća PDF, TIFF, JPG ili PNG datoteke s umetcima u RGB boji, do 50 MB i 15.000 px po strani, dostupne putem HTTPS-a bez autentifikacije. PDF-ovi s više stranica tretiraju se kao jedna stranica po sloju, a Fabrixa preuzima samu datoteku kako bi izradio ispravne datoteke za tisak kada se posao renderira.
U WooCommerceu idite na Postavke, zatim na Napredno, zatim na REST API i dodajte ključ s dozvolama za čitanje/pisanje. Zalijepite dobiveni ck_ ključ, cs_ tajnu i domenu vaše trgovine u Fabrixa, spremite i narudžbe se automatski sinkroniziraju — pravila uvoza možete kasnije promijeniti u postavkama kanala.
Prije nego što pošaljete prvu narudžbu, trebate token pristupa aplikaciji i ključ aplikacije iz prodajnog kanala, javnu HTTPS webhook krajnju točku koja provjerava HMAC-SHA256 potpis na svakom payloadu i grafiku dostupnu putem HTTPS-a bez autentifikacije. Sva tri se izdaju ili konfiguriraju na nadzornoj ploči Fabrixa, a vjerodajnice se generiraju odmah pri stvaranju prodajnog kanala.
Kod statusa 403 Application Access Token i Application Key su valjani, ali im nedostaje dopuštenje za traženi resurs. To se razlikuje od statusa 401, što znači da nedostaje obavezni header ili je token opozvan; oboje se može provjeriti GET /ping zahtjevom prije daljnjeg razvoja.
Za podršku integracije, probleme s vjerodajnicama ili prodajnim kanalima, prilagođene zahtjeve ili planiranje kapaciteta — tehnički SE kanal, a ne prodajna linija. Odgovor unutar jednog radnog dana.
Možete se povezati putem našeg REST API i feeda proizvoda, a Fabrixa Studio, naš uređivač dizajna, može se ugraditi u vašu vlastitu platformu kako bi se prikazao kao vaša vlastita značajka.
Pročitaj odgovor →Trenutno je u razvoju; naš tim radi na automatiziranoj predaji narudžbi, sinkronizaciji proizvoda, cijena i zaliha te automatskom praćenju povrata.
Pročitaj odgovor →Resursi za programere: API dokumentacija https://www.fabrixa.com/developers/api-documentation · Vodič za integraciju https://www.fabrixa.com/developers/integration-guide/ · Webhooks https://api.fabrixa.com/docs/integration#webhooks
Pročitaj odgovor →Sva 8 odgovora o integracijama i API → Obratite se našem timu za podršku →
