Obstajata dva načina za pošiljanje naročil v Fabrixa: povežite trgovino, ki jo že upravljate – Shopify ali WooCommerce – brez programiranja ali pa jo ustvarite neposredno v integraciji API. Ta vodnik obravnava oba načina: povezavo prodajnega kanala v nekaj minutah ali pot od avtorizacije do izpolnitve naročila v petnajstih minutah.
Večina trgovin sploh ne uporablja modela API. Dodajte Fabrixa kot prodajni kanal in naročila iz vaše trgovine bodo neposredno posredovana v proizvodnjo – izdelki se sinhronizirajo, stanja se posredujejo nazaj, pri tem pa ni treba pisati ali vzdrževati kode. Pot API, opisana v nadaljevanju, je namenjena prilagojenim spletnim trgovinam in platformam POD.
Na nadzorni plošči odprite Create channel in izberite vrsto integracije. Vsak kanal hrani svoje izdelke, uvožena naročila in pravila uvoza – povežite toliko kanalov, kolikor jih uporabljate.
Ni treba kopirati ključev. V upraviteljskem vmesniku Shopify odobrite Fabrixa in povezava bo vzpostavljena.
Create channel, izberite Shopify.Spletna trgovina na platformi WordPress se poveže s parom ključev REST za branje/pisanje — ki se ustvari v WooCommerce in se enkrat vnese v Fabrixa.
Settings → Advanced → REST API → Add key z Branje/pisanje dovoljenja.ck_ ključ, cs_ skrivnost in domeno vaše trgovine v Fabrixa.Prodajate izdelke po meri? Fabrixa Studio — urejevalnik oblikovanja »white-label« — je na voljo tudi v trgovinah Shopify in WooCommerce, tako da lahko vaši kupci izdelke prilagodijo po lastnih željah pod vašo blagovno znamko. Glej Fabrixa Studio →
Povezane trgovine so v pogledu »Kanali« prikazane poleg vaših kanalov API in partnerskih kanalov – sinhronizirani izdelki, prejeta naročila, zadnja uvožena referenca in prihodki po posameznem kanalu. Ko ste pripravljeni, preklopite kanal iz osnutka v aktivno stanje; nič v nadaljevanju se ne spremeni.
Ali nameravate ustvariti prilagojeno spletno trgovino ali raje lastno platformo POD? Preostanek tega vodnika je posvečen poti API – od avtentifikacije do izpolnitve naročila v štirih korakih.
Tri stvari vas popeljejo od nič do aktivnega naročila. Vse tri se izvedejo prek vašega nadzornega panela Fabrixa ali prek vašega inženirja za rešitve.
Dostopni žeton aplikacije in ključ aplikacije. Oba sta potrebna pri vsakem zahtevku – žeton v glavi »Authorization«, ključ pa v glavi »X-Application-Key«. Ustvarite prodajni kanal v nadzorni plošči, da ju takoj ustvarite – brez potrebe po pošiljanju zahtevka.
Javno dostopna HTTPS-končna točka, ki sprejema zahteve JSON POST. V razvojnem okolju deluje localhost prek tunela. Pred obdelavo preverite podpis HMAC-SHA256 na vsakem podatkovnem tovoru.
Vaša datoteka z grafičnim motivom — PDF, TIFF, JPG ali PNG — mora biti dostopna prek protokola HTTPS brez avtentifikacije. Barvni model RGB, velikost do 50 MB in 15.000 pik na stran. Večstranski PDF-ji imajo eno stran na sloj. Datoteko prenesemo in ob renderiranju naročila pripravimo ustrezne datoteke za tisk.
Vsako zahtevo se pošlje na osnovni URL https://api.fabrixa.com/v2/integration če sta oba glava nastavljena. GET /ping preden storite karkoli drugega, preveri, ali sta žeton in ključ veljavna.
Stanje 401 pomeni, da manjka glava ali da je bil žeton preklican. Stanje 403 to pomeni, da so poverilnice veljavne, vendar nimajo dovoljenja za dostop do vira.
# 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 prikaže različice izdelkov z njihovimi oznakami SKU in variant_id. Vsak odgovor na seznam je zavit v standardni links / meta / data kuverta, zato strani oštevilčite z next_page povezava. Shranjevanje v lokalnem predpomnilniku — katalog ni odvisen od posamezne zahteve.
Podrobnosti o celotnem področju so v Sklic na Swagger.
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šlji rows (SKU + količina + izvorni PDF), customer in shipping_address. Nastavite po lastni izbiri number kot referenco — če jo izpustite, jo bomo ustvarili mi. Shranite vrnjeno identifikacijsko številko naročila Fabrixa skupaj z vašim naročilom.
Naročila studia nadomeščajo sources datoteka z cart_item_key shranjenega dizajna; vse ostalo je enako.
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"
}
}
V nadzorni plošči nastavite URL-naslov svojega webhooka. Pošljemo zahtevek POST order.created in order.updated k temu s celotnim besedilom naročila, in x-webhook-signature (HMAC-SHA256) in x-webhook-topic glava. Preveri podpis, vrni 200 hitro, asinhrono obdelaj.
Vsi dogodki in odlomki za preverjanje so na Referenca za webhooke.
# 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" }
Napake se prikažejo v obliki JSON, nikoli v obliki HTML. errors.messages array navaja, kaj je šlo narobe; pri napaki 400 navaja polja, ki niso bila veljavna.
Napaka pri preverjanju veljavnosti, manjkajoča ali preklicana pooblastila, nezadostna dovoljenja ali neznan vir.
30 zahtevkov na aplikacijo na minuto. X-RateLimit-Limit in X-RateLimit-Remaining so v vsakem odgovoru.
Na strani strežnika. Poskusite ponovno z odlogom; če težava vztraja, pošljite identifikacijsko številko zahtevka svojemu inženirju za rešitve.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa omogoča 30 zahtevkov na aplikacijo na minuto; če se ta meja preseže, se vrne odgovor 429 Too Many Requests. V vsakem odgovoru sta vključena glava X-RateLimit-Limit in X-RateLimit-Remaining, tako da lahko integracija spremlja preostalo kvoto, preden doseže omejitev.
Fabrixa sprejema grafične datoteke v formatih PDF, TIFF, JPG ali PNG v barvnem prostoru RGB, z velikostjo do 50 MB in ločljivostjo do 15.000 pik na stran, dostopne prek protokola HTTPS brez avtentifikacije. Večstranski PDF-ji se obravnavajo kot ena stran na sloj, Fabrixa pa sam prenese datoteko, da ob renderiranju naloge ustvari pravilne datoteke za tiskanje.
V WooCommerce odprite Nastavitve, nato Napredno, nato REST API in dodajte ključ z dovoljenji za branje/pisanje. Vnesite pridobljeni ključ ck_, skrivni ključ cs_ in domeno vaše trgovine v Fabrixa, shranite, naročila pa se bodo sinhronizirala samodejno — pravila uvoza lahko kasneje spremenite v nastavitvah kanala.
Preden oddate prvo naročilo, potrebujete dostopni žeton aplikacije in ključ aplikacije iz prodajnega kanala, javno končno točko webhooka HTTPS, ki preverja podpis HMAC-SHA256 na vsakem podatkovnem tovoru, ter grafične datoteke, dostopne prek HTTPS brez avtentifikacije. Vse tri se izdajo ali konfigurirajo v nadzorni plošči Fabrixa, prijavni podatki pa se ustvarijo takoj ob ustvarjanju prodajnega kanala.
Napaka 403 pomeni, da sta dostopni žeton aplikacije in ključ aplikacije veljavna, vendar nimata dovoljenja za zahtevano viro. To se razlikuje od napake 401, ki pomeni, da manjka obvezni glavi ali da je bil žeton preklican; obe napaki je mogoče preveriti z zahtevkom GET /ping, preden nadaljujete z razvojem.
Za podporo pri integraciji, težave s pooblastili ali prodajnimi kanali, posebne zahteve ali načrtovanje zmogljivosti – obrnite se na tehnični kanal SE, ne na prodajno službo. Odgovor prejmete v enem delovnem dnevu.
Povezati se lahko prek našega REST API in seznama izdelkov, naš urejevalnik oblikovanja Fabrixa Studio pa lahko vgradite v svojo platformo, tako da se prikaže kot vaša lastna funkcija.
Preberi odgovor →Trenutno je v razvoju; naša ekipa dela na avtomatiziranem oddajanju naročil, sinhronizaciji izdelkov, cen in zalog ter avtomatskem sledenju vračil.
Preberi odgovor →Viri za razvijalce: Dokumentacija API https://www.fabrixa.com/developers/api-documentation · Priročnik za integracijo https://www.fabrixa.com/developers/integration-guide/ · Webhooki https://api.fabrixa.com/docs/integration#webhooks
Preberi odgovor →Vseh 8 odgovorov na temo »Integracije in API« → Obrnite se na našo službo za podporo →
