Razvijalci · Fabrixa Studio

Omogočite svojim strankam, da sami oblikujejo svoje izdelke – pod vašo blagovno znamko.

Fabrixa Studio je white-label prilagodnik, ki ga vključite na stran svojega izdelka kot iframe. Vaše stranke ustvarijo ali naložijo svoje lastne motive in si jih v živo ogledajo na izdelku – urejevalnik nosi vašo blagovno znamko, ne naše, zato nikoli ne vidijo Fabrixa. Ko končajo, naročilo oddate na podlagi shranjene prilagoditve – ni treba nalagati ali shranjevati grafičnih datotek.

Vodnik po integraciji → Odpri referenco API

White-label · Shopify, WooCommerce in po meri · Predogled v živo · Naročilo po referenčni številki

Fabrixa Studio · Predstavitev v živo

Preizkusite urejevalnik kar tukaj.

To je prav tisti urejevalnik, ki ga boste vgradili – odprite ga, vstavite grafično gradivo in oblikujte dejanski izdelek iz našega kataloga. Ni treba nič namestiti, račun ni potreben.

To je isti urejevalnik, v katerem vaši kupci oblikujejo prek modulov Shopify in WooCommerce ali prek API. Ta stran je interaktivna predstavitev – naročanje poteka na platformi, ko registrirati se.

Oglejte si urejevalnik

Vaša blagovna znamka. Oblikovanje vaših strank. Eno platno.

Studio, vgrajen v spletno trgovino — knjižnica oblik, orodja za besedilo, oblike, slike in plasti ter predogled ponavljanja vzorca v realnem času na izdelku. Deluje pod vašo blagovno znamko, tako da vaši kupci vidijo vašo trgovino, nikoli pa Fabrixa.

yourshop.com/customise

Urednik Fabrixa Studio, vgrajen v spletno trgovino – knjižnica vzorcev, besedilo, oblike, orodja za slike in plasti ter predogled ponavljanja vzorca v realnem času na pregrinjalu, izdelek pod lastno blagovno znamko trgovca

Kaj počne Studio

Orodje za prilagajanje izdelkov pod lastno blagovno znamko, vgrajeno v vaš postopek plačila.

Studio omogoča vašim strankam, da izdelke prilagodijo v realnem času – ustvarijo dizajn ali naložijo svojega – in si ga ogledajo na izdelku še pred nakupom, vse to pa pod vašo blagovno znamko.

White-label, pod vašo blagovno znamko

Urednik nosi vašo blagovno znamko, ne našo – vaši kupci prilagajajo izdelke po lastnih željah in si jih ogledujejo v realnem času, ne da bi kdaj koli videli Fabrixa.

Ustvarite ali naložite motive

V programu Studio ustvarijo dizajn ali naložijo lastno grafično gradivo, nato pa ga v urejevalniku namestijo na izdelek.

Vizualizacija izdelka v realnem času

Studio prikaže dizajn na dejanskem izdelku, tako da stranke vidijo, kaj bodo prejele, še preden ga dodajo v košarico.

Shranjeno na izdelek v košarici

Vsaka prilagoditev se shrani v povezavi z cart_item_key posredujete — eno edinstveno vrednost za vsako vrstico v košarici na vaši strani.

Predogled slike na zahtevo

Prikaži renderirano predogledno sliko za katero koli cart_item_key za prikaz v košarici, v povzetku naročila ali kjerkoli v vaši spletni trgovini.

Brez obdelave datotek

Nikoli ne spreminjajte datotek z umetniškimi deli. Uporabite cart_item_key ob naročilu, Fabrixa pa samodejno priloži shranjeni dizajn.

1. korak — Vstavljanje

En iframe na vaši strani z izdelki.

Prodajate prek Shopifyja ali WooCommerca? Studio je vgrajen v te module spletnih trgovin – preprosto ga vklopite, brez potrebe po programiranju. Za prilagojene spletne trgovine in platforme ga vgradite sami: Studio se prenaša iz studio.fabrixa.com in dodano z iframe. V URL-ju prenesite tri vrednosti – za vse ostalo poskrbi urejevalnik, ki prikazuje rešitev »white-label« pod vašo blagovno znamko.

application_key — vaš aplikacijski ključ, ki omeji vgradnjo na vaš prodajni kanal
sku — različica izdelka SKU, pridobljena iz integracije API
cart_item_key — edinstvena vrednost, ki jo ustvarite za vsako vrstico v košarici; Studio shrani to prilagoditev

stran-izdelka.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>

2. korak — Poslušaj

Studio odgovori s funkcijo postMessage.

Studio v nadrejeno okno pošlje dve sporočili. customizationFinished se sproži, ko stranka klikne Dodaj v košarico; closeButtonClicked se sproži, ko kliknejo Nazaj. Poslušajte jih na glavnem kanalu in vedno preverite event.origin.

Ko se customizationFinished ko se sproži dogodek, dodajte vrstico v košarico z istim ključem cart_item_key ki ste ga prenesli v iframe. Ta ključ povezuje vrstico s shranjenim dizajnom.

studio-events.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();
  }
});

3. korak — Predogled

Končani dizajn lahko pokažete kjerkoli.

Ko je prilagoditev shranjena, prenesite njeno renderirano sliko iz končne točke za predogled – preprosto jo nastavite kot src iz <img>. Idealno za košarico, povzetek naročila ali stran s potrditvijo.

Predogled je usklajen z istim cart_item_key, pri čemer mora biti vaš aplikacijski ključ vključen v poizvedbeni niz.

cart-preview.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">

4. korak — Naročilo

Naročilo oddajte na podlagi sklica.

Ob zaključku nakupa, POST nalog za /v2/integration/orders iz vašega backenda. Za vrstico, ki jo je stranka oblikovala v programu Studio, pošljite običajno sku in quantity in še to isto cart_item_key ki si ga posredoval v iframe. Ta ključ predstavlja shranjeno postavitev, zato ne sources Potrebna je datoteka. Fabrixa prenese prilagoditve in jih vključi v produkcijsko okolje.

cart_item_key je referenca programa Studio – uporabljajte jo le za črte, ki jih je stranka prilagodila v programu Studio. Vsaka vrstica vsebuje bodisi cart_item_key (oblikovano v programu Studio) ali datoteka z imenom sources (vaša lastna grafika: PDF, TIFF, JPG ali PNG), nikoli oboje. Vse ostalo v naročilu je enako.

POST /v2/integration/orders

{
  "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či in varnost

Ključ aplikacije v brskalniku, dostopni žeton v vašem strežniškem sistemu.

Studio in končna točka za predogled uporabljata vaš Application Key, kar je v vgrajenem predvajalniku vidno že po zasnovi — omejeno je le na urejevalnik in prikazuje predoglede za vaš kanal. Za ustvarjanje naročil je potrebno Application Access Token prav tako, in to ostane na vašem strežniku.

V brskalniku

Studio in predogled

application_key v URL-ju iframe-a Studia
Application-Key na URL-ju predogledne slike
Prikaže urejevalnik in predoglede shranjenih oblik za vaš kanal
Ni mogoče oddajati naročil, pregledovati računov ali pregledovati podatkov drugega kanala

Samo backend

Ustvarjanje naročila

Authorization: Bearer APPLICATION_ACCESS_TOKEN
X-Application-Key: APPLICATION_KEY
Ustvarjanje in spremljanje naročil prek POST /v2/integration/orders
Dostopni žeton shranite na strežniški strani – nikoli ga ne pošiljajte v kodi odjemalca

Dostop

Studio je omogočen za vsak račun posebej.

V nadzorni plošči ustvarite prodajni kanal, da pridobite aplikacijski ključ, s katerim se vgrajena rešitev avtentificira, nato pa razvijte in preizkusite rešitev na tem kanalu, preden začne sprejemati dejanska naročila. V referenčnem gradivu API je na voljo demo v živo, kjer lahko odprete Studio s svojim SKU in ključem – cene se razlikujejo glede na obseg, zato se za podrobnosti obrnite na našo ekipo.

Pogosta vprašanja

Fabrixa Studio, odgovoril

Za kaj se uporablja Fabrixa Studio?

Fabrixa Studio je orodje za prilagajanje izdelkov pod lastno blagovno znamko, ki ga trgovci vgradijo na svojo stran z izdelki kot iframe. Kupci ustvarijo ali naložijo svoje lastne dizajne in si jih v živo ogledajo na izdelku, in sicer pod blagovno znamko trgovca, ne pa pod blagovno znamko Fabrixa. Naročilo se nato odda na podlagi shranjene prilagoditve, zato ni treba nalagati ali shranjevati datotek z grafičnimi elementi.

Kako vgradim Fabrixa Studio na stran svojega izdelka?

Dodajte iframe, ki kaže na studio.fabrixa.com, in v URL-ju prenesite tri vrednosti: application_key za omejitev vključitve na vaš prodajni kanal, sku za različico izdelka ter cart_item_key, edinstveno vrednost, ki jo ustvarite za vsako vrstico v košarici in na podlagi katere Studio shrani prilagoditve. Vse ostalo, vključno z blagovno znamko urednika, se obdeluje znotraj Studia.

Ali Fabrixa Studio obvesti mojo spletno trgovino, ko stranka zaključi oblikovanje?

Studio z metodo `postMessage` pošlje dve sporočili v nadrejeno okno: `customizationFinished`, ki se sproži, ko stranka klikne »Dodaj v košarico«, in `closeButtonClicked`, ki se sproži, ko stranka klikne »Nazaj«. Vaša stran mora pred odzivom na katero koli od sporočil preveriti event.origin, nato pa dodati vrstico v košarico z istim ključem cart_item_key, ki je bil posredovan v iframe.

Kako povežem zasnovo iz Studia z naročilom?

Ko pošiljate zahtevek POST na naslov /v2/integration/orders, v vrstico naročila vključite isti cart_item_key, ki ste ga posredovali v iframe Studia, skupaj s sku in količino. Ta ključ predstavlja shranjeno zasnovo, zato za to vrstico ni potrebna datoteka sources – vsaka vrstica naročila vsebuje bodisi cart_item_key bodisi datoteko sources, nikoli pa oboje.

Ali je varno, da se ključ aplikacije, ki se uporablja v programu Fabrixa Studio, razkrije v brskalniku?

Da — ključ aplikacije je v vgrajeni različici Studia namerno viden — omejen je le na urejevalnik in predogled slike za vaš prodajni kanal ter ne more oddajati naročil, brati podatkov o zaračunavanju ali dostopati do podatkov drugega kanala. Za ustvarjanje naročil je potreben tudi ločen dostopni žeton aplikacije, ki ostane na vašem strežniku in se pošilja kot žeton »Bearer«.

Ste pripravljeni na integracijo?

Dodajte Studio v svojo spletno trgovino.

Ustvarite prodajni kanal za generiranje ključev in vgradite Studio še danes. Potrebujete pomoč pri nastavitvi dogodkov ali poteka naročil? Obrnite se na inženirja za rešitve – odgovor boste prejeli v enem delovnem dnevu.

Obrnite se na inženirja za rešitve Preberite priročnik za integracijo