Prejsť na hlavný obsah
Žiadosť typu Fabrixa API na obrazovke — dátová časť požiadavky vo formáte JSON s autentizačnými hlavičkami, týkajúca sa tkanej textílie
Dokumentácia k API

Jeden koncový bod. Nekonečné množstvo produktov.

Každý Fabrixa, SKU, každá látka, každá úprava – prístupné prostredníctvom jedného zdokumentovaného REST API. Vstup JSON, výstup JSON. Webhooky pre každý prechod do nového stavu. Kľúče API na vlastné použitie – vytvorte predajný kanál a začnite tvoriť.

REST · JSON · Webhooky · Vloženie do Studia · Swagger

Čo získate

Vytvorené na základe toho, ako výroba skutočne funguje.

Dokumentované rozhranie REST API, ktoré odzrkadľuje funkcie platformy – objednávky, vybavovanie, prispôsobenie v Studio a webhooky. Vstup v formáte JSON, výstup v formáte JSON. Môžete ho používať spolu s riadiacim panelom alebo všetko ovládať programovo.

01
Objednávky
POST /v2/integration/orders

Odošlite objednávku obsahujúcu riadky, zdrojové súbory PDF, údaje o zákazníkovi a dodaciu adresu. Vráti identifikačné číslo objednávky Fabrixa. Polia pre prepravnú etiketu a sledovanie zásielky sú voliteľné.

02
Fulfilment
GET /orders/{id}/fulfillments

Zobraziť stav výroby podľa jednotlivých položiek: každý krok (tlač, úprava, pranie, šitie) so stavmi „čaká na spracovanie“, „v procese“, „hotové“ a „zamietnuté“. Alebo sa prihláste k odberu webhookov pre push notifikácie.

03
Štúdio
vloženie iframe

Zabudujte Fabrixa Studio do svojho internetového obchodu. Zákazníci si môžu produkty prispôsobovať v reálnom čase, a to pomocou udalostí postMessage pre pridanie do košíka a návrat späť, ako aj prostredníctvom URL adresy s náhľadom miniatúr v košíku.

04
Webhooky
order.created / order.updated

Dve témy: dátové časti podpísané pomocou HMAC-SHA256, telo správy v plnom poradí, doručenie s 10 opakovanými pokusmi a odkladom.

Rýchly štart

Zadajte objednávku v jednom príspevku.

Overená žiadosť, overené údaje, rezervované miesto v produkčnej fronte. Potvrdenie dorazí za niekoľko milisekúnd – objednávka vášho zákazníka je teraz v procese spracovania.

Úplná schéma, všetky koncové body, chybové kódy, obmedzenia frekvencie a príklady integrácie sú uvedené v technickej dokumentácii.

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"
  }
}
Integračný postup

Spustenie za dva týždne. Bez proxy, bez middlewaru.

Priama integrácia REST do vašej platformy. Nie je potrebné žiadne SDK, žiadny proxy server ani konektor tretej strany. Štandardný protokol HTTP z vášho prostredia do nášho.

01
Kvalifikácia

Získajte prístupový token aplikácie a kľúč aplikácie vytvorením predajného kanála vo vašom riadiacom paneli. Oba sú potrebné pri každej požiadavke: token typu „Bearer“ pri autorizácii a kľúč aplikácie v poli X-Application-Key.

02
Katalóg

Prezrite si online referenčnú príručku Swagger, kde nájdete varianty SKUs pre produkty, ktoré chcete predávať, ako aj vzory filtrovania a stránkovania.

03
Objednávky

Pri dokončení objednávky odošlite požiadavku typu POST obsahujúcu riadky, zdroje (URL adresy súborov PDF), údaje o zákazníkovi a dodaciu adresu. Vrátené identifikačné číslo objednávky Fabrixa uložte spolu s vaším vlastným referenčným číslom objednávky.

04
Webhooky

Zverejnite verejný POST koncový bod. Každú dátovú časť podpisujeme pomocou HMAC-SHA256 (x-webhook-signature), aby ste mohli pred spracovaním overiť jej pravosť.

05
Štúdio

Voliteľné: vložte iframe Fabrixa Studio na stránku vášho produktu. Zákazníci si produkt prispôsobujú priamo naživo; svoje úpravy pripájajú k objednávke prostredníctvom metódy POST.

Zdroje pre vývojárov

Všetko, čo potrebuje váš technický tím.

Úplná referenčná štruktúra API

Kompletná dokumentácia koncových bodov, schémy požiadaviek a odpovedí, chybové kódy, obmedzenia frekvencie, overovanie, integrácia so Studio a zmluvy o webhookoch – s interaktívnym rozhraním Swagger.

Otvoriť dokumenty →

Vytvoriť s ohľadom na predajný kanál

Vytvorte si špecializovaný predajný kanál, na ktorom budete môcť pracovať – zadávajte testovacie objednávky, overujte doručenie webhookov, testujte okrajové prípady – a potom nasmerujte skutočnú návštevnosť na váš aktívny kanál. Vaše kľúče sú pripravené hneď po vytvorení kanála – bez nutnosti podávať žiadosť.

Vytvorte si účet →

Kolekcia Postman

Vopred nakonfigurovaná zbierka požiadaviek s ukážkovými dátami a overovaním. Importujte ju do svojho testovacieho pracovného postupu.

Získajte túto kolekciu →
Bezpečnosť

Autorizácia s dvoma hlavičkami. Podpísané webhooky. Obmedzenie rýchlosti.

Štandardné postupy, žiadne prekvapenia. Každá požiadavka je overená pomocou tokenu typu „Bearer“ aj aplikačného kľúča. Každý webhook je na účely overenia podpísaný algoritmom HMAC a podlieha predvídateľným limitom frekvencie pre každú aplikáciu.

Prístupový token aplikácie

Token „Bearer“ v hlavičke „Authorization“. Identifikuje volajúcu aplikáciu.

Kľúč aplikácie

Odosiela sa v hlavičke X-Application-Key. Obe sú povinné pri každej požiadavke – ak chýba niektorá z nich, vráti sa kód 401.

Šifrovanie TLS

Na stránke api.fabrixa.com sa používa výhradne protokol HTTPS. Žiadosti v nezakódovanom texte sú odmietnuté na okraji siete.

Podpisy webhookov

Každý webhook je podpísaný pomocou HMAC-SHA256 a podpis sa odosiela v hlavičke x-webhook-signature. Pred spracovaním ho overte.

Limity rýchlosti

30 požiadaviek na aplikáciu za minútu. V každej odpovedi sa vracajú hlavičky X-RateLimit-Limit a X-RateLimit-Remaining.

Opakované pokusy o webhook

Až 10 pokusov o doručenie v prípade odpovede, ktorá nie je typu 2xx ani 3xx. Po 10. neúspešnom pokuse sa webhook deaktivuje.

Často kladené otázky

Integrácia API, odpoveď

Ako sa môžem prihlásiť pomocou Fabrixa a API?

Každá požiadavka musí obsahovať dve hlavičky: prístupový token aplikácie zaslaný ako token typu „Bearer“ v hlavičke „Authorization“ a kľúč aplikácie v hlavičke „X-Application-Key“. Obe sa vygenerujú v okamihu, keď vytvoríte predajný kanál v riadiacom paneli Fabrixa, a ak niektorá z týchto hlavičiek chýba, požiadavka bude odmietnutá s chybovým kódom 401.

Môžem si vyskúšať režimy Fabrixa a API pred odoslaním skutočných príkazov?

Áno — vytvorte špeciálny predajný kanál, na ktorom budete pracovať, zadajte testovacie objednávky, overte doručenie webhookov a otestujte okrajové prípady. Akonáhle bude kanál fungovať, nasmerujte naň skutočnú prevádzku. Registráciou a vytvorením tohto kanála budú váš prístupový token aplikácie a kľúč aplikácie ihneď k dispozícii, bez potreby samostatnej žiadosti.

Je integrácia Fabrixa API šifrovaná protokolom HTTPS?

Áno — služba API na adrese api.fabrixa.com funguje výlučne cez protokol HTTPS a akákoľvek požiadavka v nezakódovanom texte je na okraji siete odmietnutá. Každá požiadavka je tiež overená pomocou tokenu Bearer aj aplikačného kľúča a každá dátová časť webhooku je podpísaná algoritmom HMAC-SHA256, aby ju bolo možné overiť pred spracovaním.

Čo vráti požiadavka POST na /v2/integration/orders?

Overená požiadavka POST na adresu /v2/integration/orders overí obsah požiadavky, rezervuje miesto v produkčnej fronte a vráti potvrdenie s identifikačným číslom objednávky Fabrixa v milisekundách spolu s voliteľnými políčkami pre prepravnú etiketu a sledovanie zásielky. Plnenie objednávky je potom možné sledovať podľa jednotlivých položiek alebo vám môže byť zaslané prostredníctvom webhookov.

Potrebujem na integráciu s Fabrixa a API SDK alebo proxy?

Nie — integrácia fabrixa prebieha prostredníctvom priameho REST pripojenia cez štandardný protokol HTTP, bez nutnosti používať SDK, proxy server ani konektor tretej strany. Službu fabrixa voláte priamo zo svojho vlastného softvérového prostredia pomocou požiadaviek a odpovedí vo formáte JSON, pričom na oznamovanie zmien stavu slúžia webhooky.

Začnite stavať

Vytvorte si predajný kanál a začnite s jeho budovaním už dnes.

Zaregistrujte sa, vytvorte predajný kanál a vaše prihlasovacie údaje pre API budú ihneď pripravené. Potrebujete pomoc? Naši technickí špecialisti vám odpovedia do 24 hodín – väčšina tímov je pripravená na prevádzku už za dva týždne.

Základňa znalostí

Máte otázky týkajúce sa integrácií a API?

Všetkých 8 odpovedí na tému Integrácie a API → Obráťte sa na náš tím podpory →