01
Narudžbe
POST /v2/integracija/narudžbe
Pošaljite narudžbu s redovima, izvornim PDF-ovima, podacima o kupcu i adresom za dostavu. Vraća ID narudžbe Fabrixa. Opcionalna polja za etiketu za dostavu i praćenje.
API dokumentacija
Jedan kraj. Beskonačni proizvodi.
Svaki Fabrixa SKU, svaka tkanina, svaki završni sloj — dostupno putem jednog dokumentiranog REST API sučelja. JSON u, JSON iz. Webhooks za svaku promjenu stanja. Samoposlužni API ključevi — stvorite prodajni kanal i počnite graditi.
Što dobivate
Izgrađeno oko toga kako produkcija zapravo funkcionira.
Dokumentirani REST API koji odražava platformu — narudžbe, ispunjenje, prilagodbu u Studiju i webhooke. JSON u, JSON iz. Koristite ga uz nadzornu ploču ili pokrenite sve programatski.
02
Fulfilment
DOBIJ /narudžbe/{id}/isporuke
Prikaži status proizvodnje po stavci: svaki korak (štampanje, popravak, pranje, šivanje) sa stanjima čekanje / u tijeku / gotovo / odbijeno. Ili se pretplatite na webhooke za push obavijesti.
03
Studio
Ugradnja iframea
Ugradite Fabrixa Studio u svoju trgovinu. Kupci prilagođavaju proizvode u stvarnom vremenu, uz postMessage događaje za dodavanje u košaricu i povratak, te URL za pretpregled minijatura košarice.
04
Webhooks
narudžba.kreirana / narudžba.ažurirana
Dvije teme, HMAC-SHA256 potpisane payloadove, cjelovito tijelo naloga, dostava s 10 pokušaja uz povlačenje.
Brzi početak
Naručite u jednoj pošti.
Autentificirani zahtjev, validirana pošiljka, slot rezerviran u proizvodnoj redu. Potvrda u milisekundama — narudžba vašeg kupca sada je u obradi.
Potpuna shema, svi krajevi točaka, kodovi pogrešaka, ograničenja stope i primjeri integracije nalaze se u tehničkoj dokumentaciji.
POST /v2/integracija/narudžbe
// 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" } }
Integracijski tok
Uživo za dva tjedna. Bez posrednika, bez posrednog softvera.
Izravna REST integracija u vašu platformu. Nije potreban SDK, proxy poslužitelj ni konektor treće strane. Standardni HTTP iz vašeg stacka u naš.
01
Akreditacije
Dobijte token pristupa aplikaciji i ključ aplikacije tako da u svojoj nadzornoj ploči kreirate prodajni kanal. Oba su potrebna u svakom zahtjevu: Bearer token u Authorization, Application Key u X-Application-Key.
02
Katalog
Pregledajte Swagger referencu uživo kako biste pronašli varijantu SKUs za proizvode koje želite prodavati, kao i obrasce filtriranja i paginacije.
03
Narudžbe
Prilikom dovršetka kupnje pošaljite POST s redovima, izvorima (URL-ovima PDF-ova), kupcem i adresom dostave. Pohranite vraćeni ID narudžbe Fabrixa uz vlastitu referencu narudžbe.
04
Webhooks
Otkrijte javni POST krajnji punkt. Potpisujemo svaki payload HMAC-SHA256 (x-webhook-signature) kako biste mogli provjeriti autentičnost prije obrade.
05
Studio
Opcionalno: umetnite iframe Fabrixa Studija na stranicu proizvoda. Kupci personaliziraju uživo; priložite njihove prilagodbe narudžbi pri POST-u.
Resursi za programere
Sve što je vašem inženjerskom timu potrebno.
Potpuna API referenca
Potpuna dokumentacija krajnje točke, sheme zahtjeva/odgovora, kodovi pogrešaka, ograničenja brzine, autentifikacija, ugradnja Studija i webhook ugovori — s interaktivnim Swagger sučeljem.
Otvori dokumente →Izgraditi protiv prodajnog kanala
Stvorite namjenski prodajni kanal za razvoj — pošaljite testne narudžbe, provjerite isporuku webhooka, potvrdite rubne slučajeve — zatim usmjerite stvarni promet na svoj aktivni kanal. Vaši su ključevi spremni čim stvorite kanal — nema koraka zahtjeva.
Kreirajte svoj račun →Prikupljanje pošte
Unaprijed konfigurirana zbirka zahtjeva s primjerima payloada i autentifikacije. Uvezite je u svoj tijek rada za testiranje.
Preuzmi kolekciju →
Sigurnost
Dvostruka provjera ovlaštenja. Potpisani webhooki. S ograničenjem brzine.
Standardne prakse, bez iznenađenja. Svaki zahtjev se autentificira i Bearer tokenom i Application Keyjem. Svaki webhook je HMAC-potpisan za verifikaciju, s predvidivim ograničenjima brzine po aplikaciji.
Pristupni token za aplikaciju
Token nositelja u zaglavlju Autorizacija. Identificira pozivajuću aplikaciju.
Ključ primjene
Pošaljite u zaglavlju X-Application-Key. Oba su obavezna u svakom zahtjevu — ako nedostaje bilo koji, vraća se status 401.
TLS enkripcija
Samo HTTPS na api.fabrixa.com. Zahtjevi u običnom tekstu se na rubu odbijaju.
Potpisi webhooka
Svaki webhook potpisan je HMAC-SHA256 i poslan u zaglavlju x-webhook-signature. Provjerite prije obrade.
Ograničenja brzine
30 zahtjeva po aplikaciji u minuti. X-RateLimit-Limit i X-RateLimit-Remaining vraćaju se u svakom odgovoru.
Ponovni pokušaji webhooka
Do 10 pokušaja dostave pri odgovoru koji nije 2xx ili 3xx. Webhook se deaktivira nakon 10. neuspjeha.
Često postavljana pitanja
Integracija API, odgovoreno
Kako se autentificirati s Fabrixa API?
Svaki zahtjev zahtijeva dva zaglavlja: Application Access Token poslan kao Bearer token u zaglavlju Authorization i Application Key u zaglavlju X-Application-Key. Oba se generiraju u trenutku kada kreirate prodajni kanal na Fabrixa nadzornoj ploči, a zahtjev se odbija kodom 401 ako jedno od zaglavlja nedostaje.
Mogu li testirati Fabrixa i API prije slanja stvarnih narudžbi?
Da — stvorite namjenski prodajni kanal za razvoj, pošaljite testne narudžbe, provjerite isporuku webhooka i potvrdite rubne slučajeve, a zatim usmjerite stvarni promet na svoj aktivni kanal kad bude funkcionalan. Registracija i stvaranje tog kanala odmah čine vaš token za pristup aplikaciji i ključ aplikacije dostupnima, bez zasebnog koraka zahtjeva.
Je li integracija Fabrixa šifrirana HTTPS-om API?
Da — API je na api.fabrixa.com dostupan samo putem HTTPS-a, a svaki zahtjev u običnom tekstu odbacuje se na rubu mreže. Svaki se zahtjev također autentificira i Bearer tokenom i Application Keyjem, a svaki payload webhooka potpisan je HMAC-SHA256 kako bi se mogao provjeriti prije obrade.
Što vraća POST na /v2/integration/orders?
Autentificirani POST na /v2/integration/orders provjerava payload, rezervira mjesto u produkcijskom redu i vraća potvrdu s ID-om narudžbe Fabrixa u milisekundama, zajedno s opcionalnim poljima za etiketu dostave i praćenje. Ispunjenje se potom može pratiti po stavci ili vam se proslijediti putem webhooks-a.
Trebam li SDK ili proxy za integraciju s Fabrixa API?
Ne — integracija fabrixa-a je izravna REST veza preko standardnog HTTP-a, bez obaveznog SDK-a, bez proxy poslužitelja i bez potrebe za konektorom treće strane. Pozivate API izravno iz vlastite tehnološke platforme koristeći JSON zahtjeve i odgovore, uz webhooke za promjene stanja.
Počni graditi
Kreirajte prodajni kanal i počnite graditi danas.
Registrirajte se, kreirajte prodajni kanal i vaši API podaci za prijavu spremni su odmah. Trebate pomoć? Naši inženjeri za rješenja odgovaraju u roku od 24 sata — većina timova je aktivna za dva tjedna.