Arendajad · Fabrixa Studio

Andke oma klientidele võimalus kujundada ise oma tooteid – teie kaubamärgi all.

Q: Kas Fabrixa Studio rakenduses kasutatavat rakendusvõtit on ohutu brauseris avalikustada?

Jah — rakenduse võti on Studio sisseehitatud lahenduses kavandatud viisil nähtav — see piirab toimetaja ja eelvaatepildi juurdepääsu ainult teie müügikanalile ning ei võimalda tellimuste esitamist, arvelduste vaatamist ega juurdepääsu teise kanali andmetele. Tellimuste loomiseks on vaja ka eraldi rakenduse juurdepääsutokeni, mis jääb teie tagapõhja ja saadetakse „Bearer“-tokenina.

Fabrixa Studio on white-label kohandaja, mille lisad oma tootelehele kui iframe. Teie kliendid loovad või laadivad üles oma kujundused ja vaatavad neid reaalajas tootel – redaktor kannab teie, mitte meie brändi, seega ei näe nad kunagi Fabrixa-d. Kui nad on valmis, esitate tellimuse salvestatud kujunduse alusel – kunstifailide üleslaadimist ega salvestamist ei ole vaja.

Integreerimisjuhend → Ava API viide

White-label · Shopify, WooCommerce ja kohandatud lahendused · Reaalajas eelvaade · Tellimine viitenumbri järgi

Fabrixa Studio · Reaalajas demo

Proovi toimetajat kohe siin.

See ongi just see redaktor, mida saaksid veebilehele lisada – ava see, lisa pilt ja kujunda meie kataloogist päris toode. Midagi pole vaja installida, kontot pole vaja.

See on sama redaktor, mida teie kliendid kasutavad disainimiseks Shopify ja WooCommerce moodulite või API kaudu. See leht on reaalajas prooviversioon – tellimine toimub platvormil, kui te registreerida.

Vaata toimetajat

Teie bränd. Teie kliendi disain. Üks pind.

Kaupluse esiküljesse integreeritud Studio – disainiraamatukogu, teksti-, kujundite-, pildi- ja kihitööriistad ning toote reaalajas kordusvaade. See töötab valge sildi põhimõttel, seega näevad teie kliendid teie poodi, mitte kunagi Fabrixa-d.

yourshop.com/customise

Veebipoodi integreeritud Fabrixa Studio redaktor – disainikogu, teksti-, kujundite-, pildi- ja kihitööriistad ning mustri kordamise reaalajas eelvaade tekil, valge sildiga müüja kaubamärgi all

Mida Studio teeb

Teie kassasse integreeritud valge sildi kohandaja.

Studio võimaldab teie klientidel tooteid reaalajas isikupärastada – luua disaini või laadida üles oma disain – ning näha seda tootel enne ostu sooritamist, ja seda kõike teie brändi raames.

White-label, teie kaubamärgi all

Redaktor kannab teie, mitte meie brändi – teie kliendid saavad tooteid reaalajas isikupärastada ja eelvaatada, ilma et nad Fabrixa-d üldse näeksid.

Disainide loomine või üleslaadimine

Nad loovad kujunduse Studio keskkonnas või laadivad üles oma kujunduse ning paigutavad selle seejärel tootele toimetajas.

Toote visualiseerimine reaalajas

Studio kuvab kujunduse tegelikul tootel, nii et kliendid näevad, mida nad saavad, enne kui toote ostukorvi lisavad.

Säästetud iga ostukorvi toote kohta

Iga kohandus salvestatakse seoses cart_item_key Teie poolt esitatud andmed – üks unikaalne väärtus iga ostukorvi rea kohta.

Pildi eelvaade soovi korral

Lae renderdatud eelvaatepilt mis tahes cart_item_key et seda kuvada ostukorvis, tellimuse kokkuvõttes või kus tahes teie poes.

Failide käitlemine puudub

Ära kunagi puuduta kujundusfaile. Kasuta viidet cart_item_key tellimuse alusel ja Fabrixa lisab salvestatud kujunduse automaatselt.

1. samm — Lisamine

Üks iframe teie tootelehel.

Kas müüd Shopify või WooCommerce kaudu? Studio on nendesse poemoodulitesse sisse ehitatud – lülita see lihtsalt sisse, koodi pole vaja. Kohandatud veebipoodide ja platvormide puhul lisa see ise: Studio pakutakse aadressilt studio.fabrixa.com ja lisati koos iframe. Edasta URL-is kolm väärtust – kõige muu eest hoolitseb redaktor, mis kuvab valge sildi Teie brändi all.

application_key — teie rakenduse võti, millega piiritletakse sisseehitatud rakenduse ulatus teie müügikanaliga
sku — tootevariant SKU, mis on saadud integratsioonist API
cart_item_key — iga ostukorvi rea kohta loodud unikaalne väärtus; Studio salvestab selle alusel tehtud kohandused

toote-leht.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. samm — Kuula

Studio vastab funktsiooniga postMessage.

Studio saadab kaks sõnumit ülemaaknasse. customizationFinished käivitub, kui klient klõpsab Lisa ostukorvi; closeButtonClicked süttib, kui nad klõpsavad Tagasi. Kuula neid vanemal ja kontrolli alati event.origin.

Kui customizationFinished kui sündmus käivitub, lisa rida oma ostukorvi, kasutades sama võtit cart_item_key mille Teie edastasid iframe’i. See võti seob rea salvestatud kujundusega.

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. samm — Eelvaade

Näita valmis kujundust kus tahes.

Kui kohandus on salvestatud, lae selle renderdatud pilt eelvaate-lõpppunktist – määra see lihtsalt src ... <img>. Sobib ideaalselt ostukorvi, tellimuse kokkuvõtte või kinnituslehele.

Eelvaade on sünkroniseeritud sama cart_item_key, kus päringustringis on märgitud teie rakendusvõti.

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. samm — Tellimine

Esitage tellimus viitenumbri alusel.

Kassasse minnes, POST korraldus /v2/integration/orders teie tagapõhja kaudu. Kui klient on Studio-s kujundanud rea, saatke tavapärane sku ja quantity pluss sama cart_item_key mida Teie iframe’i edastasid. See võti on salvestatud kujundus, seega mitte sources Vaja on faili. Fabrixa laadib kohandused alla ja viib need tootmisse.

cart_item_key on Studio viide – kasuta seda ainult nende ridade puhul, mida klient on Studio-s kohandanud. Igas reas on kas cart_item_key (koostatud programmis Studio) või fail nimega sources (teie enda kujundus: PDF, TIFF, JPG või PNG), mitte kunagi mõlemat. Kõik muu tellimuses on identne.

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": { "...": "..." }
}

Võtmed ja turvalisus

Rakenduse võti brauseris, juurdepääsutoken teie tagapõhisüsteemis.

Studio ja eelvaate lõpppunkt kasutavad Teie Application Key, mis on sisseehitatud lahenduse tõttu nähtav — see hõlmab ainult redigeerijat ja kuvab eelvaateid teie kanali jaoks. Tellimuste loomiseks on vaja Application Access Token samuti, ja see jääb teie tagapõhja.

Veebibrauseris

Stuudio ja eelvaade

application_key Studio iframe’i URL-is
Application-Key eelvaatepildi URL-il
Kuvab teie kanali redaktori ja salvestatud kujunduste eelvaateid
Ei ole võimalik tellimusi esitada, arveid vaadata ega teise kanali andmeid vaadata

Ainult backend

Tellimuse loomine

Authorization: Bearer APPLICATION_ACCESS_TOKEN
X-Application-Key: APPLICATION_KEY
Tellimuste loomine ja jälgimine kaudu POST /v2/integration/orders
Hoidke juurdepääsutokenit serveripoolel – ärge kunagi edastage seda kliendi koodis

Juurdepääs

Studio on aktiveeritud iga konto kohta.

Loo oma juhtpaneelis müügikanal, et genereerida rakendusvõti, mille abil sisseehitatud lahendus end autentifitseerib, ning seejärel arenda ja testi seda kanalit enne, kui see hakkab vastu võtma tegelikke tellimusi. API-viites on olemas reaalajas demo, kus saate avada Studio omaenda SKU-ga ja võtmega – hinnad sõltuvad mahuastmest, seega pöörduge üksikasjade saamiseks meie meeskonna poole.

KKK

Fabrixa Studio vastas

Milleks kasutatakse Fabrixa Studio't?

Fabrixa Studio on valge sildi põhimõttel töötav tootekohandaja, mille müüjad lisavad oma tootelehele iframe’ina. Kliendid loovad või laadivad üles oma kujundused ja vaatavad neid reaalajas tootel eelvaatena, kusjuures toode kannab müüja, mitte Fabrixa brändi. Tellimus esitatakse seejärel salvestatud kohanduse alusel viitepõhiselt, mistõttu ei ole vaja ühtegi kujundusfaili üles laadida ega salvestada.

Kuidas saan Fabrixa Studio oma tootelehele lisada?

Lisa iframe, mis viitab aadressile studio.fabrixa.com, ja edasta URL-is kolm väärtust: application_key, et piirata sisseehitatud elementi Teie müügikanaliga; sku, mis tähistab tootevarianti; ning cart_item_key – unikaalne väärtus, mille Teie genereerid iga ostukorvi rea kohta ja mille alusel Studio salvestab kohandused. Kõik muu, sealhulgas toimetaja bränding, hallatakse Studio keskkonnas.

Kas Fabrixa Studio teavitab minu veebipoodi, kui klient on disaini valmis saanud?

Studio saadab postMessage’i abil vanemaknasse kaks sõnumit: „customizationFinished”, mis käivitub, kui klient klõpsab nuppu „Lisa ostukorvi”, ja „closeButtonClicked”, mis käivitub, kui klient klõpsab nuppu „Tagasi”. Teie leht peaks enne mõlema sõnumi töötlemist kontrollima event.origin väärtust ning seejärel lisama toote ostukorvi, kasutades sama cart_item_key väärtust, mis edastati iframe’ile.

Kuidas seostada Studio disain tellimusega?

Kui saadad POST-päringu aadressile /v2/integration/orders, lisa tellimuse reale sama cart_item_key, mille edastasid Studio iframe’ile, koos SKU-koodi ja kogusega. See võti on salvestatud disain, seega ei ole selle rea jaoks vaja sources-faili – iga tellimuse rida sisaldab kas cart_item_key-võtit või sources-faili, mitte kunagi mõlemat.

Kas Fabrixa Studio rakenduses kasutatavat rakendusvõtit on ohutu brauseris avalikustada?

Jah — rakendusvõti on Studio sisseehitatud lahenduses kavandatud viisil nähtav — see piirab toimetaja ja eelvaatepildi juurdepääsu ainult teie müügikanalile ning ei võimalda tellimuste esitamist, arvelduste vaatamist ega juurdepääsu teise kanali andmetele. Tellimuste loomiseks on vaja ka eraldi rakenduse juurdepääsutokeni, mis jääb teie tagapõhja ja saadetakse „Bearer“-tokenina.

Kas olete valmis integreerima?

Lisa Studio oma veebipoodi.

Loo müügikanal, et genereerida oma võtmed ja integreerida Studio juba täna. Vajate abi sündmuste või tellimisprotsessi seadistamisel? Võta ühendust lahenduste inseneriga – vastus saate ühe tööpäeva jooksul.

Võtke ühendust lahenduste inseneriga Loe integratsiooni juhendit