Programeri · Fabrixa Studio

Omogućite svojim kupcima da dizajniraju vlastite proizvode — pod vašim brendom.

Q: Za što se koristi Fabrixa Studio?

Fabrixa Studio je alat za prilagodbu white-label proizvoda koji trgovci ugrađuju na stranicu proizvoda kao iframe. Kupci stvaraju ili učitavaju vlastite dizajne i pregledavaju ih uživo na proizvodu, pod brendom trgovca, a ne pod brendom Fabrixa. Narudžba se zatim zaprima na temelju spremljene prilagodbe, tako da nije potrebno ni učitavati ni pohranjivati datoteku s dizajnom.

Fabrixa Studio je white-label prilagoditelj koji ugrađujete na stranicu svog proizvoda kao iframe. Vaši kupci stvaraju ili učitavaju vlastite dizajne i pregledavaju ih uživo na proizvodu — uređivač nosi vaš brending, a ne naš, pa nikada ne vide Fabrixa. Kad završe, narudžbu izvršavate prema spremljenoj prilagodbi — nema potrebe za učitavanjem ili pohranjivanjem datoteka s dizajnom.

Vodič za integraciju → Otvorite referencu API

White-label · Shopify, WooCommerce i prilagođeno · Živi pregled · Sortiraj po referenci

Fabrixa Studio · Živa demonstracija

Isprobajte uređivač upravo ovdje.

Ovo je točno onaj uređivač koji biste ugradili — otvorite ga, ubacite grafike i dizajnirajte stvarni proizvod iz našeg kataloga. Ništa za instalirati, nije potreban račun.

To je isti uređivač u kojem vaši kupci dizajniraju putem Shopify i WooCommerce modula ili API. Ova stranica je živa demonstracija — naručivanje se odvija na platformi čim vi Registrirajte se.

Pogledajte urednika

Vaš brending. Dizajn vašeg kupca. Jedno platno.

Studio ugrađen u izlog — dizajnerska biblioteka, alati za tekst, oblike, slike i slojeve te pregled uživo ponovljenih uzoraka na proizvodu. Radi pod vašim brendom, pa vaši kupci vide samo vašu trgovinu, nikada Fabrixa.

yourshop.com/customise

Ugrađeni urednik Fabrixa Studio u izlogu trgovine — biblioteka dizajna, alati za tekst, oblike, slike i slojeve te pregled ponavljanja uzoraka uživo na jorganu, s bijelom oznakom pod trgovačkim brendom

Što Studio radi

Prilagodnik white-label, ugrađen u vaš postupak plaćanja.

Studio omogućuje vašim kupcima personalizaciju proizvoda u stvarnom vremenu — izraditi dizajn ili učitati vlastiti — i vidjeti ga na proizvodu prije kupnje, sve pod vašim brendom.

White-label, pod vašim brendom

Uređivač nosi vaš brending, a ne naš — vaši kupci personaliziraju i pregledavaju proizvode u stvarnom vremenu, a da nikada ne vide Fabrixa.

Stvorite ili učitajte dizajne

Izrađuju dizajn unutar Studija ili učitaju vlastiti grafički materijal, a zatim ga postavljaju na proizvod u uređivaču.

Živa vizualizacija proizvoda

Studio prikazuje dizajn na stvarnom proizvodu, tako da kupci vide što će dobiti prije nego što ga dodaju u košaricu.

Sačuvano po artiklu u košarici

Svaka prilagodba pohranjuje se uz cart_item_key Vi isporučujete — jednu jedinstvenu vrijednost po redku košarice na vašoj strani.

Pregledna slika na zahtjev

Dođite do renderirane pretpregledne slike za bilo koji cart_item_key za prikaz u košarici, sažetku narudžbe ili bilo gdje u vašoj trgovini.

Nema rukovanja datotekama

Nikada ne dirajte datoteke s umjetničkim djelima. Pozovite cart_item_key po narudžbi i Fabrixa automatski prilaže spremljeni dizajn.

Korak 1 — Ugradnja

Jedan iframe na vašoj stranici proizvoda.

Prodajete na Shopifyju ili WooCommerceu? Studio je ugrađen u te module trgovine — uključite ga, nije potreban kod. Za prilagođene izloge i platforme, sami ga ugradite: Studio se isporučuje s studio.fabrixa.com i dodano s iframe. Proslijedite tri vrijednosti putem URL-a — sve ostalo se obrađuje unutar uređivača, koji prikazuje white-label pod vašim brendiranjem.

application_key — vaš Application Key, ograničava ugradnju na vaš prodajni kanal
sku — varijanta proizvoda SKU, preuzeta iz integracije API
cart_item_key — jedinstvena vrijednost koju generirate po retku košarice; Studio sprema prilagodbu uz nju

stranica-proizvoda.html

<!-- Embed Fabrixa Studio on your product page -->
<iframe id="fabrixa-studio"
  src="https://studio.fabrixa.com?application_key=APPLICATION_KEY&sku=COF099191&cart_item_key=CART_ITEM_KEY"
  name="FabrixaStudio"
  scrolling="no" frameborder="1"
  width="100%" height="100%" allowfullscreen>
</iframe>

Korak 2 — Slušajte

Studio odgovara pomoću postMessage.

Studio šalje dvije poruke roditeljskom prozoru. customizationFinished aktivira se kada kupac klikne Dodaj u košaricu; closeButtonClicked Pali se kad kliknu Natrag. Slušajte ih na roditelju i uvijek provjerite event.origin.

Kada customizationFinished event fires, dodajte liniju u svoju košaricu s istim ključem cart_item_key Ušli ste u iframe. Taj ključ povezuje liniju sa spremljenim dizajnom.

studijski-događaji.js

window.addEventListener("message", (event) => {
  // Always check the origin first
  if (event.origin !== "https://studio.fabrixa.com") return;

  if (event.data === "customizationFinished") {
    // Add to Cart → store the line keyed by your cart_item_key
    addToCart(cartItemKey);
  } else if (event.data === "closeButtonClicked") {
    // Back → close the editor / restore the product page
    closeStudio();
  }
});

Korak 3 — Pregled

Prikažite gotov dizajn bilo gdje.

Nakon što se prilagodba spremila, dohvati njezinu renderiranu sliku s endpointa za pretpregled — samo je postavi kao src jednog <img>. Idealno za košaricu, sažetak narudžbe ili stranicu za potvrdu.

Pregled je ključan istim cart_item_key, sa svojim ključem aplikacije u upitnom nizu.

prikaz-kolašice.html

<!-- Rendered preview of the saved customisation -->
<img
  src="https://api.fabrixa.com/v2/studio/customizations/CART_ITEM_KEY/preview?Application-Key=APPLICATION_KEY"
  alt="Customised product preview"
  style="max-width:100%;height:auto">

Korak 4 — Narudžba

Naručite po referenci.

Pri naplati, POST nalog da /v2/integration/orders iz vašeg backenda. Za liniju koju je kupac dizajnirao u Studiju, pošaljite uobičajeno sku i quantity plus isto cart_item_key Ušli ste u iframe. Taj ključ je spremljeni dizajn, pa ne. sources Datoteka je potrebna. Fabrixa preuzima prilagodbu i stavlja je u proizvodnju.

cart_item_key je referenca studija — koristite je samo za retke koje je kupac prilagodio u studiju. Svaki red nosi ili cart_item_key (dizajnirano u studiju) ili datoteka naziva sources (vaša vlastita grafika: PDF, TIFF, JPG ili PNG), nikada oboje. Sve ostalo u narudžbi je identično.

POST /v2/integracija/narudžbe

{
  "number": "NL2026063001",
  "purchased_at": "2026-06-30 12:00:00",
  "rows": [
    {
      "sku": "SB796162",
      "quantity": 1,
      "cart_item_key": "0cb76770-de2d-4524-aa48-47b6e5f0d8a5"
    }
  ],
  "customer":         { "first_name": "Maria", "email": "maria@example.com" },
  "shipping_address": { "...": "..." }
}

Ključevi i sigurnost

Ključ aplikacije u pregledniku, pristupni token na vašem backendu.

Studio i pretpregledna krajnja točka koriste vaš Application Key, što je ugradnjom predviđeno — to ograničava samo na uređivač i prikazuje preglede za vaš kanal. Kreiranje narudžbi zahtijeva Application Access Token također, i to ostaje na vašem backendu.

U pregledniku

Studio i najava

application_key na URL-u Studio iframea
Application-Key na URL-u sličice pregleda
Prikazuje uređivač i pretpreglede spremljenih dizajna za vaš kanal
Ne može se izvršiti narudžba, pregledati naplatu ili pristupiti podacima drugog kanala

Samo backend

Stvaranje narudžbe

Authorization: Bearer APPLICATION_ACCESS_TOKEN
X-Application-Key: APPLICATION_KEY
Kreirajte i pratite narudžbe putem POST /v2/integration/orders
Držite Access Token na strani poslužitelja — nikada ga ne šaljite u klijentski kod

Pristup

Studio je omogućen po računu.

U nadzornoj ploči stvorite prodajni kanal za generiranje ključa aplikacije s kojim se ugradnja autentificira, a zatim na tom kanalu izradite i testirajte prije nego što počne primati stvarne narudžbe. U referenci API nalazi se demo u stvarnom vremenu u kojem možete otvoriti Studio sa svojim SKU i ključem — cijene variraju ovisno o razini obujma, stoga se obratite našem timu za detalje.

Često postavljana pitanja

Fabrixa Studio je odgovorio

Za što se koristi Fabrixa Studio?

Fabrixa Studio je white-label prilagodnik proizvoda koji trgovci ugrađuju na stranicu proizvoda kao iframe. Kupci stvaraju ili učitavaju vlastite dizajne i pregledavaju ih uživo na proizvodu, pod brendom trgovca, a ne pod brendom Fabrixa-a. Narudžba se potom zaprima na temelju spremljene prilagodbe, tako da nije potrebno ni učitavati ni pohranjivati datoteku s dizajnom.

Kako mogu ugraditi Fabrixa Studio na svoju stranicu proizvoda?

Dodajte iframe koji upućuje na studio.fabrixa.com i u URL proslijedite tri vrijednosti: application_key za povezivanje ugrađene komponente s vašim prodajnim kanalom, sku za varijantu proizvoda i cart_item_key, jedinstvenu vrijednost koju generirate za svaki redak u košarici, a prema kojoj Studio pohranjuje prilagodbu. Sve ostalo, uključujući brendiranje uređivača, rješava se unutar Studija.

Obavještava li Fabrixa Studio moju trgovinu kada kupac dovrši dizajn?

Studio šalje dvije poruke roditeljskom prozoru pomoću postMessage: customizationFinished, koja se pokreće kada korisnik klikne na Dodaj u košaricu, i closeButtonClicked, koja se pokreće kada klikne na Nazad. Vaša stranica treba provjeriti event.origin prije nego što reagira na bilo koju poruku, a zatim dodati redak u košaricu koristeći isti cart_item_key koji je proslijeđen u iframe.

Kako povezati Studio dizajn s narudžbom?

Pošaljite isti cart_item_key koji ste proslijedili u Studio iframe kao redak narudžbe, zajedno sa sku i količinom, kada šaljete POST na /v2/integration/orders. Taj ključ je spremljeni dizajn, stoga za taj redak nije potreban izvornik — svaki redak narudžbe nosi ili cart_item_key ili izvornik, nikada oboje.

Je li Application Key koji se koristi u Fabrixa Studiju siguran za izlaganje u pregledniku?

Da — Application Key je namjerno vidljiv u Studio embedu — on samo ograničava uređivač i prikaznu sliku na vaš prodajni kanal i ne može vršiti narudžbe, čitati podatke o naplati ili pristupati podacima drugog kanala. Za izradu narudžbi također je potreban zaseban Application Access Token, koji ostaje na vašem backendu i šalje se kao Bearer token.

Spremni za integraciju?

Dodajte Studio u svoj izlog.

Kreirajte prodajni kanal za generiranje svojih ključeva i ugrađivanje Studija već danas. Trebate pomoć pri postavljanju događaja ili protoka narudžbi? Obratite se inženjeru za rješenja — odgovor u roku od jednog radnog dana.

Kontaktirajte inženjera za rješenja Pročitajte vodič za integraciju