Odešlete objednávku obsahující řádky, zdrojové soubory PDF, údaje o zákazníkovi a dodací adresu. Vrátí ID objednávky ve formátu Fabrixa. Volitelná pole pro přepravní štítek a sledování zásilky.
Jedno koncové zařízení. Nekonečné množství produktů.
Každý Fabrixa, SKU, každá látka, každá povrchová úprava – vše přístupné prostřednictvím jednoho zdokumentovaného REST API rozhraní. Vstup JSON, výstup JSON. Webhooky pro každý přechod mezi stavy. Samoobslužné klíče API – vytvořte prodejní kanál a začněte tvořit.
Je postaveno na tom, jak výroba ve skutečnosti funguje.
Dokumentované rozhraní REST API, které odráží funkčnost platformy – objednávky, vyřizování, přizpůsobení ve Studiu a webhooky. Vstup i výstup ve formátu JSON. Můžete jej používat společně s řídicím panelem nebo vše řídit programově.
Zobrazit stav výroby podle jednotlivých položek: každý krok (tisk, úprava, praní, šití) se stavy „čeká na zpracování“, „v procesu“, „hotovo“ a „zamítnuto“. Nebo se přihlaste k odběru webhooků pro push notifikace.
Začleňte Fabrixa Studio do svého internetového obchodu. Zákazníci si mohou produkty přizpůsobovat v reálném čase, a to pomocí událostí `postMessage` pro přidání do košíku a návrat zpět, a také pomocí URL s náhledem miniatur v košíku.
Dvě témata: datové části podepsané pomocí HMAC-SHA256, tělo zprávy v plném pořadí, doručení s 10 opakovanými pokusy a odkladem.
Proveďte objednávku v jednom příspěvku.
Ověřený požadavek, ověřená data, rezervované místo ve frontě produkčního prostředí. Potvrzení dorazí během několika milisekund – objednávka vašeho zákazníka je nyní v procesu vyřizování.
Kompletní schéma, všechny koncové body, kódy chyb, limity frekvence a příklady integrace najdete v technické dokumentaci.
// 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" } }
Spuštění za dva týdny. Bez proxy, bez middlewaru.
Přímá integrace REST do vaší platformy. Není potřeba žádné SDK, žádný proxy server ani konektor od třetí strany. Standardní HTTP z vašeho systému do našeho.
Získejte přístupový token aplikace a klíč aplikace vytvořením prodejního kanálu ve vašem ovládacím panelu. Oba jsou vyžadovány při každém požadavku: token typu „Bearer“ v poli „Authorization“ a klíč aplikace v poli „X-Application-Key“.
Projděte si online referenční příručku Swagger a najděte varianty SKUs pro produkty, které chcete prodávat, včetně vzorů pro filtrování a stránkování.
Při dokončení objednávky odešlete požadavek POST obsahující řádky, zdroje (URL adresy PDF), údaje o zákazníkovi a dodací adresu. Vrátěné ID objednávky Fabrixa uložte pod svým vlastním referenčním číslem objednávky.
Zpřístupněte veřejný POST koncový bod. Každé datové zatížení podepisujeme pomocí HMAC-SHA256 (x-webhook-signature), abyste mohli před zpracováním ověřit jeho pravost.
Volitelně: vložte iframe Fabrixa Studio na stránku svého produktu. Zákazníci si produkt přizpůsobují v reálném čase; své úpravy připojí k objednávce pomocí metody POST.
Vše, co váš technický tým potřebuje.
Úplný referenční dokument k API
Kompletní dokumentace koncových bodů, schémata požadavků a odpovědí, chybové kódy, omezení frekvence, ověřování, integrace do Studia a smlouvy o webhookech – s interaktivním rozhraním Swagger.
Otevřít dokumenty →Vytvořit s ohledem na prodejní kanál
Vytvořte si speciální prodejní kanál, na kterém budete moci provádět testy – zadávejte zkušební objednávky, ověřujte doručení webhooků, testujte okrajové případy – a poté nasměrujte skutečný provoz na váš ostrý kanál. Vaše klíče jsou připraveny ihned po vytvoření kanálu – není třeba podávat žádost.
Vytvořte si účet →Kolekce Postman
Předkonfigurovaná sada požadavků s ukázkovými daty a ověřováním. Importujte ji do svého testovacího pracovního postupu.
Získejte tuto kolekci →Ověřování pomocí dvou hlaviček. Podepsané webhooky. Omezení rychlosti.
Standardní postupy, žádná překvapení. Každý požadavek je ověřován jak tokenem typu „Bearer“, tak aplikačním klíčem. Každý webhook je pro ověření podepsán algoritmem HMAC a podléhá předvídatelným limitům frekvence pro jednotlivé aplikace.
Přístupový token aplikace
Token „Bearer“ v hlavičce Authorization. Identifikuje volající aplikaci.
Klíč aplikace
Odesílá se v hlavičce X-Application-Key. Obě jsou povinné u každého požadavku – chybí-li některá z nich, vrátí se stavový kód 401.
Šifrování TLS
Na api.fabrixa.com se používá výhradně protokol HTTPS. Žádosti v prostém textu jsou na okraji sítě odmítnuty.
Podpisy webhooků
Každý webhook je podepsán pomocí algoritmu HMAC-SHA256 a podpis je odeslán v hlavičce x-webhook-signature. Před zpracováním jej ověřte.
Limity rychlosti
30 požadavků na aplikaci za minutu. V každé odpovědi se vrací hodnoty X-RateLimit-Limit a X-RateLimit-Remaining.
Opakované pokusy o webhook
Až 10 pokusů o doručení v případě odpovědi jiné než 2xx nebo 3xx. Po 10. neúspěšném pokusu se webhook deaktivuje.
Integrace API, odpověď
Jak se mohu přihlásit k zařízení Fabrixa API?
Každý požadavek musí obsahovat dvě hlavičky: přístupový token aplikace (Application Access Token) odeslaný jako token typu „Bearer“ v hlavičce „Authorization“ a klíč aplikace (Application Key) v hlavičce „X-Application-Key“. Oba se generují v okamžiku, kdy vytvoříte prodejní kanál v řídicím panelu Fabrixa, a pokud některá z těchto hlaviček chybí, bude požadavek odmítnut s chybovým kódem 401.
Mohu si vyzkoušet režimy Fabrixa a API před odesláním skutečných objednávek?
Ano – vytvořte speciální prodejní kanál, na kterém budete pracovat, odešlete testovací objednávky, ověřte doručení webhooků a otestujte okrajové případy. Jakmile bude vše fungovat, nasměrujte skutečný provoz na váš produkční kanál. Po registraci a vytvoření tohoto kanálu budete mít okamžitě k dispozici přístupový token aplikace a klíč aplikace, aniž byste museli provádět samostatný krok žádosti.
Je integrace Fabrixa API šifrována protokolem HTTPS?
Ano – služba API na adrese api.fabrixa.com podporuje výhradně protokol HTTPS a jakýkoli požadavek v prostém textu je na okraji sítě odmítnut. Každý požadavek je navíc ověřován jak tokenem Bearer, tak aplikačním klíčem, a každá data webhooku jsou podepsána algoritmem HMAC-SHA256, aby je bylo možné před zpracováním ověřit.
Co vrátí požadavek POST na adresu /v2/integration/orders?
Ověřený požadavek POST na adresu /v2/integration/orders ověří obsah požadavku, rezervuje místo ve frontě produkčního prostředí a vrátí potvrzení s ID objednávky Fabrixa v milisekundách, spolu s volitelnými poli pro přepravní štítek a sledování zásilky. Plnění objednávky lze poté sledovat po jednotlivých položkách nebo vám může být zasláno prostřednictvím webhooků.
Potřebuji k integraci s Fabrixa a API SDK nebo proxy?
Ne — integrace služby fabrixa probíhá prostřednictvím přímého REST připojení přes standardní protokol HTTP, aniž by bylo nutné používat SDK, proxy server nebo konektor třetí strany. Se službou fabrixa komunikujete přímo ze svého vlastního systému pomocí požadavků a odpovědí ve formátu JSON, přičemž ke sledování změn stavu slouží webhooky.
Vytvořte si prodejní kanál a začněte s budováním ještě dnes.
Zaregistrujte se, vytvořte prodejní kanál a vaše přihlašovací údaje pro API budou okamžitě k dispozici. Potřebujete pomoc? Naši technici vám odpoví do 24 hodin – většina týmů je v provozu do dvou týdnů.


