Přejít na hlavní obsah
Žádost typu Fabrixa API na obrazovce — datová část objednávky ve formátu JSON s autentizačními hlavičkami, týkající se tkané textilie
Dokumentace k API

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.

REST · JSON · Webhooky · Vložení do Studia · Swagger

Co získáte

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ě.

01
Objednávky
POST /v2/integration/orders

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.

02
Fulfilment
GET /orders/{id}/fulfillments

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.

03
Studio
vložení iframe

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.

04
Webhooky
order.created / order.updated

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.

Rychlý start

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 /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"
  }
}
Průběh integrace

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.

01
Kvalifikace

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“.

02
Katalog

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í.

03
Objednávky

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.

04
Webhooky

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.

05
Studio

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.

Zdroje pro vývojáře

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 →
Bezpečnost

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.

Často kladené otázky

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.

Začněte stavět

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ů.

Znalostní databáze

Máte dotazy ohledně integrací a API?

Všech 8 odpovědí na téma „Integrace a API“ → Zeptejte se našeho týmu podpory →