01
Naročila
POST /v2/integration/orders
Pošljite naročilo z vrsticami, izvirnimi PDF-datotekami, podatki o stranki in naslovom za dostavo. Vrne ID naročila Fabrixa. Polja za pošiljko in sledenje so neobvezna.
Dokumentacija za API
Ena končna točka. Neskončno število izdelkov.
Vsak Fabrixa, SKU, vsaka tkanina, vsaka obdelava – dostopna prek enega dokumentiranega REST API. Vhod JSON, izhod JSON. Webhooki za vsak prehod med stanji. Ključi API za samostojno uporabo – ustvarite prodajni kanal in začnite graditi.
Kaj boste prejeli
Zasnovano na podlagi dejanskega poteka proizvodnje.
Dokumentirani REST API, ki odraža delovanje platforme – naročila, izpolnjevanje naročil, prilagajanje v Studiu in webhooki. Vhod v formatu JSON, izhod v formatu JSON. Uporabljajte ga skupaj z nadzorno ploščo ali pa vse upravljajte programsko.
02
Fulfilment
GET /naročila/{id}/izpolnitve
Prikaži stanje proizvodnje po posameznih postavkah: vsak korak (tiskanje, popravljanje, pranje, šivanje) s stanji »v čakanju«, »v teku«, »zaključeno« in »zavrnjeno«. Ali pa se naročite na webhooke za prejem obvestil.
03
Studio
vstavljanje iframe-a
Vključite Fabrixa Studio v svojo spletno trgovino. Kupci lahko izdelke prilagajajo v realnem času, pri čemer so na voljo dogodki »postMessage« za dodajanje v košarico in vrnitev nazaj ter URL za predogled sličic v košarici.
04
Spletni hooki
order.created / order.updated
Dve temi: podatkovni tokovi, podpisani s HMAC-SHA256, celotno besedilo naročila, dostava z 10 ponovnimi poskusi in odlogom.
Hitri začetek
Naročilo oddajte v enem samem prispevku.
Preverjena zahteva, potrjena vsebina, rezervirano mesto v produkcijski čakalni vrsti. Potrditev v nekaj milisekundah – naročilo vašega stranke je zdaj v obdelavi.
Celotna shema, vse končne točke, kode napak, omejitve hitrosti in primeri integracije so na voljo v tehnični dokumentaciji.
POST /v2/integration/orders
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "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" } }
Potek integracije
V živo čez dva tedna. Brez proxyja, brez vmesne programske opreme.
Neposredna integracija REST v vašo platformo. Ni potreben SDK, ni potreben proxy strežnik, ni potreben konektor tretje stranke. Standardni HTTP iz vašega sistema v našega.
01
Potrdila
Pridobite dostopni žeton aplikacije in ključ aplikacije tako, da v nadzorni plošči ustvarite prodajni kanal. Oba sta potrebna pri vsakem zahtevku: žeton »Bearer« pri avtorizaciji, ključ aplikacije pa v polju »X-Application-Key«.
02
Katalog
Preglejte referenčni vir Swagger v realnem času, da poiščete variante SKUs za izdelke, ki jih želite prodajati, ter vzorce za filtriranje in razvrščanje po straneh.
03
Naročila
Ob zaključku nakupa pošljite zahtevek POST z vrsticami, viri (URL-ji PDF-datotek), podatki o kupcu in naslovom za dostavo. Vrnjeno ID naročila Fabrixa shranite skupaj z vašo lastno referenčno številko naročila.
04
Spletni hooki
Objavite javno končno točko POST. Vsak podatek podpišemo z HMAC-SHA256 (x-webhook-signature), da lahko pred obdelavo preverite njegovo pristnost.
05
Studio
Neobvezno: vstavite iframe Fabrixa Studio na stran s svojim izdelkom. Stranke lahko izdelek prilagodijo v realnem času; svoje prilagoditve priložijo naročilu s POST-zahtevkom.
Viri za razvijalce
Vse, kar potrebuje vaša inženirska ekipa.
Celotna referenca API
Celotna dokumentacija končnih točk, sheme zahtevkov in odgovorov, kod napak, omejitve hitrosti, avtentifikacija, vgradnja v Studio in pogodbe za webhooke – z interaktivnim vmesnikom Swagger.
Odpri dokumente →Razvijajte v skladu s prodajnim kanalom
Ustvarite namenski prodajni kanal, na katerem boste gradili sistem – oddajte testna naročila, preverite dostavo webhookov, preverite mejne primere –, nato pa usmerite dejanski promet na vaš delujoči kanal. Vaši ključi so pripravljeni takoj, ko ustvarite kanal – brez dodatnega koraka za zahtevo.
Ustvarite svoj račun →Zbirka Postman
Vnaprej konfigurirana zbirka zahtevkov s primernimi vsebinami in avtentifikacijo. Uvozite jo v svoj testni delovni tok.
Oglejte si kolekcijo →
Varnost
Dvojna avtentifikacija. Podpisani spletni hooki. Omejena hitrost.
Standardni postopki, brez presenečenj. Vsaka zahteva se avtentificira tako s tokenom »Bearer« kot z aplikacijskim ključem. Vsak webhook je za preverjanje podpisan s HMAC-om, pri čemer veljajo predvidljive omejitve števila zahtevkov na aplikacijo.
Dostopni žeton aplikacije
Token »Bearer« v glavi »Authorization«. Identificira aplikacijo, ki pošilja zahtevo.
Ključ aplikacije
Poslano v glavi X-Application-Key. Oboje je obvezno pri vsakem zahtevku – če kateri koli od njiju manjka, se vrne napaka 401.
Šifriranje TLS
Na naslovu api.fabrixa.com je na voljo izključno HTTPS. Zahtevki v obliki navadnega besedila se zavrnejo na robu omrežja.
Podpisi spletnih kljuk
Vsak webhook je podpisan z HMAC-SHA256, podpis pa je poslan v glavi x-webhook-signature. Pred obdelavo preverite veljavnost podpisa.
Omejitve hitrosti
30 zahtevkov na aplikacijo na minuto. V vsakem odgovoru se vrneta X-RateLimit-Limit in X-RateLimit-Remaining.
Ponovni poskusi webhooka
Do 10 poskusov dostave ob odzivu, ki ni 2xx ali 3xx. Webhook se po 10. neuspešnem poskusu deaktivira.
Pogosta vprašanja
Integracija API, odgovorjeno
Kako se avtentificiram pri Fabrixa in API?
Vsak zahtevek mora vsebovati dva glava: dostopni žeton aplikacije, poslan kot žeton »Bearer« v glavi »Authorization«, in ključ aplikacije v glavi »X-Application-Key«. Oba se ustvarita takoj, ko v nadzorni plošči Fabrixa ustvarite prodajni kanal, zahtevek pa se zavrne s kodeksom napake 401, če kateri koli od glav manjka.
Ali lahko preizkusim Fabrixa in API, preden oddam dejanska naročila?
Da – ustvarite namenski prodajni kanal, na katerem boste gradili sistem, oddajte testna naročila, preverite dostavo webhookov in potrdite mejne primere, nato pa, ko bo kanal deloval, usmerite dejanski promet na vaš aktivni kanal. Z registracijo in ustvarjanjem tega kanala bosta vaš dostopni žeton aplikacije in ključ aplikacije takoj na voljo, brez ločenega koraka zahtevka.
Ali je integracija Fabrixa API šifrirana s protokolom HTTPS?
Da — storitev API na naslovu api.fabrixa.com deluje izključno prek protokola HTTPS, zato se vsaka zahteva v obliki navadnega besedila zavrne že na vstopni točki. Vsako zahtevo se avtentificira tako z žetonom »Bearer« kot z aplikacijskim ključem, vsak webhook pa je podpisan z HMAC-SHA256, da se ga lahko preveri pred obdelavo.
Kaj vrne zahteva POST na /v2/integration/orders?
Avtentificirani POST-zahtevek na /v2/integration/orders preveri vsebino zahtevka, rezervira mesto v produkcijski čakalni vrsti in v milisekundah vrne potrditev z ID-jem naročila Fabrixa, skupaj z neobveznimi polji za pošiljko in sledljivostjo. Izpolnitev naročila je nato mogoče spremljati po posameznih postavkah ali pa vam jo posredujemo prek spletnih kljuk.
Ali potrebujem SDK ali proxy za integracijo s Fabrixa in API?
Ne — integracija fabrixa poteka prek neposredne povezave REST prek standardnega protokola HTTP, pri čemer ni potreben noben SDK, noben proxy strežnik in noben konektor tretje osebe. Na fabrixa se povežete neposredno iz lastnega sistema z uporabo zahtevkov in odgovorov v formatu JSON, spremembe stanja pa se sporočajo prek webhookov.
Začnite graditi
Ustvarite prodajni kanal in začnite z razvojem še danes.
Registrirajte se, ustvarite prodajni kanal in vaši podatki za prijavo v sistem API bodo takoj pripravljeni. Potrebujete pomoč? Naši inženirji za rešitve odgovorijo v 24 urah – večina ekip začne delovati v dveh tednih.