Izstrādātāji · Fabrixa Studio

Ļaujiet saviem klientiem izstrādāt savus produktus — ar jūsu zīmolu.

Q: Vai ir droši atklāt pārlūkprogrammā Fabrixa Studio lietotnes atslēgu?

Jā — lietojumprogrammas atslēga pēc savas būtības ir redzama „Studio“ iestrādātajā risinājumā — tā tikai piesaista redaktoru un priekšskatījuma attēlu jūsu pārdošanas kanālam un nevar veikt pasūtījumus, apskatīt rēķinus vai piekļūt cita kanāla datiem. Pasūtījumu izveidei ir nepieciešams arī atsevišķs lietojumprogrammas piekļuves žetons, kas paliek jūsu serverī un tiek nosūtīts kā „Bearer“ žetons.

„Fabrixa Studio“ ir „white-label“ pielāgošanas rīks, ko jūs ievietojat savā produkta lapā kā iframe. Jūsu klienti izveido vai augšupielādē savus dizainus un tos uzreiz apskata uz produkta — redaktors atspoguļo jūsu zīmolu, nevis mūsu, tāpēc viņi nekad neredz Fabrixa. Kad viņi ir pabeiguši, jūs veicat pasūtījumu, atsaucoties uz saglabāto individualizāciju — nav nepieciešams augšupielādēt vai glabāt grafiskos failus.

Integrācijas rokasgrāmata → Atveriet API atsauci

„White-label“ · Shopify, WooCommerce un pielāgotas platformas · Priekšskatījums reāllaikā · Pasūtīt pēc atsauces numura

Fabrixa Studio · Demo tiešraidē

Izmēģiniet redaktoru tieši šeit.

Šis ir tieši tas redaktors, ko jūs varētu ievietot — atveriet to, ievietojiet attēlu un izveidojiet reālu produktu no mūsu kataloga. Nav nekas jāinstalē, nav nepieciešams konts.

Tas ir tas pats redaktors, ko jūsu klienti izmanto, veidojot dizainu ar Shopify un WooCommerce moduļiem vai API. Šī lapa ir reāla izmēģinājuma versija — pasūtīšana notiek platformā, tiklīdz jūs reģistrēties.

Apskatiet redaktoru

Jūsu zīmols. Jūsu klienta dizains. Viena platforma.

Veikala vitrīnā iebūvēta studija — dizaina bibliotēka, teksta, figūru, attēlu un slāņu rīki, kā arī atkārtojuma priekšskatījums reāllaikā uz produkta. Tā darbojas kā „white-label” risinājums, tādējādi jūsu klienti redz jūsu veikalu, nevis Fabrixa.

yourshop.com/customise

Veikala saskarnē iebūvētais „Fabrixa Studio“ redaktors — dizaina bibliotēka, teksta, figūru, attēlu un slāņu rīki, kā arī reāllaika raksta atkārtojuma priekšskatījums uz segas, ar neuzrakstītu etiķeti, kas atbilst tirgotāja zīmolam

Ar ko nodarbojas „Studio“

„White-label“ pielāgošanas rīks, kas integrēts jūsu norēķinu procesā.

„Studio“ ļauj jūsu klientiem reāllaikā personalizēt produktus — izveidot dizainu vai augšupielādēt savu — un apskatīt to uz produkta pirms pirkšanas, un viss notiek saskaņā ar jūsu zīmola identitāti.

„White-label“ risinājums ar jūsu zīmolu

Redaktors atspoguļo jūsu zīmolu, nevis mūsu — jūsu klienti var personalizēt un apskatīt produktus reāllaikā, nemaz neredzot Fabrixa.

Izveidot vai augšupielādēt dizainus

Viņi izveido dizainu programmā „Studio“ vai augšupielādē savu grafiku, pēc tam redaktorā to novieto uz izstrādājuma.

Produkta vizualizācija reāllaikā

„Studio“ attēlo dizainu uz reālā izstrādājuma, tādējādi klienti var redzēt, ko tie saņems, pirms to pievieno grozam.

Ietaupījums par katru preces vienību grozā

Katra pielāgojuma dati tiek saglabāti saistībā ar cart_item_key jūs sniedzat — vienu unikālu vērtību par katru groza rindu no jūsu puses.

Attēla priekšskatīšana pēc pieprasījuma

Ielādējiet renderētu priekšskatījuma attēlu jebkuram cart_item_key lai parādītu grozā, pasūtījuma kopsavilkumā vai jebkur citur jūsu veikalā.

Nav failu apstrādes

Jūs nekad nedrīkstat mainīt mākslas darbu failus. Izmantojiet cart_item_key pēc pasūtījuma, un Fabrixa automātiski pievieno saglabāto dizainu.

1. solis — Ievietot

Viens iframe jūsu produktu lapā.

Pārdodat preces Shopify vai WooCommerce? „Studio“ ir integrēts šajos veikalu moduļos — vienkārši ieslēdziet to, nav nepieciešamas programmēšanas prasmes. Pielāgotām veikalu saskarnēm un platformām to varat ievietot paši: „Studio“ tiek nodrošināts no studio.fabrixa.com un pievienoja ar iframe. URL adresē norādiet trīs vērtības — par visu pārējo rūpējas redaktors, kas attēlo „white-label” risinājumu ar jūsu zīmola elementiem.

application_key — jūsu lietojumprogrammas atslēga, kas ierobežo iestrādes darbības jomu līdz jūsu pārdošanas kanālam
sku — produkta variants SKU, iegūts no integrācijas API
cart_item_key — unikāla vērtība, ko jūs norādāt katrai groza rindai; „Studio“ saglabā šai rindai piešķirto pielāgojumu

produkta-lapa.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. solis — Klausies

Studija atbild, izmantojot postMessage.

„Studio“ nosūta divus ziņojumus galvenajam logam. customizationFinished iedegas, kad klients uzklikšķina Pievienot grozam; closeButtonClicked iedegas, kad uz tām noklikšķina Atpakaļ. Pievērsiet uzmanību tiem galvenajā programmā un vienmēr pārbaudiet event.origin.

Kad customizationFinished ja notiek notikums, pievienojiet rindu savam grozam, izmantojot to pašu atslēgvārdu cart_item_key ko Jūs ievadīji iframe. Šī atslēga saista šo rindu ar saglabāto dizainu.

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. solis — Priekšskatīšana

Parādiet gatavo dizainu jebkur.

Kad pielāgojums ir saglabāts, lejupielādējiet tā renderētu attēlu no priekšskatīšanas galapunkta — vienkārši iestatiet to kā src par kādu <img>. Ideāli piemērots iepirkumu grozam, pasūtījuma kopsavilkumam vai apstiprinājuma lapai.

Priekšskatījumam tiek piemērots tas pats cart_item_key, iekļaujot savu lietojumprogrammas atslēgu vaicājuma virknē.

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. solis — Pasūtījums

Veiciet pasūtījumu, norādot atsauces numuru.

Veicot norēķinu, POST lai /v2/integration/orders no jūsu servera. Attiecībā uz līniju, ko klients izveidojis programmā „Studio“, nosūtiet parasto sku un quantity plus tas pats cart_item_key ko Jūs nodevi iframe. Šī atslēga ir saglabātais dizains, tāpēc nē sources Ir nepieciešams fails. Fabrixa pārņem pielāgojumus un ievieš tos ražošanā.

cart_item_key ir „Studio“ atsauce — to izmantojiet tikai tām līnijām, kuras klients ir pielāgojis programmā „Studio“. Katrā rindā ir vai nu cart_item_key (izstrādāts programmā „Studio”) vai fails ar nosaukumu sources (jūsu paša grafika: PDF, TIFF, JPG vai PNG), nekad abi vienlaikus. Pārējie pasūtījuma nosacījumi ir identiski.

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

Atslēgas un drošība

Lietojumprogrammas atslēga pārlūkprogrammā, piekļuves žetons jūsu serverī.

„Studio“ un priekšskatīšanas galapunkts izmanto jūsu Application Key, kas iestrādātajā elementā ir redzams pēc dizaina — tas attiecas tikai uz redaktoru un parāda priekšskatus jūsu kanālam. Pasūtījumu izveidei ir nepieciešams Application Access Token arī tas, un tas paliek jūsu serverī.

Pārlūkprogrammā

Studija un priekšskatījums

application_key par „Studio“ iframe URL
Application-Key uz priekšskatījuma attēla URL
Parāda redaktoru un saglabāto dizainu priekšskatījumus jūsu kanālam
Nav iespējams veikt pasūtījumus, apskatīt rēķinus vai pārbaudīt cita kanāla datus

Tikai backend

Pasūtījuma izveide

Authorization: Bearer APPLICATION_ACCESS_TOKEN
X-Application-Key: APPLICATION_KEY
Izveidojiet un izsekot pasūtījumus, izmantojot POST /v2/integration/orders
Saglabājiet piekļuves žetonu servera pusē — nekad neiekļaujiet to klienta kodā

Piekļuve

Studija tiek aktivizēta katram kontam atsevišķi.

Izveidojiet pārdošanas kanālu savā vadības panelī, lai ģenerētu lietojumprogrammas atslēgu, ar kuru tiek veikta iebūvētās lietojumprogrammas autentifikācija, pēc tam izstrādājiet un pārbaudiet to, izmantojot šo kanālu, pirms tas sāk apstrādāt reālus pasūtījumus. API atsauces materiālā ir pieejama reāla demonstrācija, kurā varat atvērt Studio, izmantojot savu SKU un atslēgu — cenas atšķiras atkarībā no apjoma līmeņa, tāpēc sazinieties ar mūsu komandu, lai uzzinātu sīkāku informāciju.

Bieži uzdotie jautājumi

Fabrixa Studio, atbildēja

Kādiem mērķiem tiek izmantots „Fabrixa Studio“?

„Fabrixa Studio“ ir „white-label“ produktu pielāgošanas rīks, ko tirgotāji ievieto savā produktu lapā kā iframe. Klienti izveido vai augšupielādē savus dizainus un tos var apskatīt reāllaikā uz produkta, izmantojot tirgotāja zīmolu, nevis „Fabrixa“ zīmolu. Pasūtījums tiek veikts, atsaucoties uz saglabāto pielāgojumu, tādējādi nav nepieciešams augšupielādēt vai saglabāt grafisko failu.

Kā ievietot Fabrixa Studio savā produkta lapā?

Pievienojiet iframe, kas norāda uz studio.fabrixa.com, un URL adresē norādiet trīs vērtības: application_key, lai ierobežotu iestrādāšanu jūsu pārdošanas kanālam, sku — produkta varianta identifikators, un cart_item_key — unikāla vērtība, ko jūs ģenerējat katrai groza pozīcijai un pret kuru Studio saglabā pielāgojumus. Viss pārējais, ieskaitot redaktora zīmola elementus, tiek apstrādāts Studio vidē.

Vai „Fabrixa Studio“ paziņo manam veikalam, kad klients pabeidz dizainu?

„Studio“ nosūta divus ziņojumus galvenajam logam, izmantojot `postMessage`: `customizationFinished`, kas tiek izsaukta, kad klients noklikšķina uz „Pievienot grozam“, un `closeButtonClicked`, kas tiek izsaukta, kad klients noklikšķina uz „Atpakaļ“. Pirms reaģēt uz kādu no šiem ziņojumiem, jūsu lapai ir jāpārbauda `event.origin`, pēc tam jāpievieno prece grozam, izmantojot to pašu `cart_item_key`, kas tika nodots iframe.

Kā saistīt „Studio“ dizainu ar pasūtījumu?

Kad veicat POST pieprasījumu uz /v2/integration/orders, kā pasūtījuma rindu nosūtiet to pašu cart_item_key, ko ievadījāt Studio iframe, kopā ar sku un daudzumu. Šī atslēga ir saglabātais dizains, tādēļ šai rindai nav nepieciešams sources fails — katrā pasūtījuma rindā ir vai nu cart_item_key, vai sources fails, nekad abi vienlaikus.

Vai ir droši atklāt pārlūkprogrammā Fabrixa Studio lietotnes atslēgu?

Jā — lietojumprogrammas atslēga pēc ieceres ir redzama „Studio“ iestrādātajā risinājumā — tā tikai piesaista redaktoru un priekšskatījuma attēlu jūsu pārdošanas kanālam un nevar veikt pasūtījumus, apskatīt rēķinus vai piekļūt cita kanāla datiem. Pasūtījumu izveidei ir nepieciešams arī atsevišķs lietojumprogrammas piekļuves žetons, kas paliek jūsu serverī un tiek nosūtīts kā „Bearer“ žetons.

Vai esat gatavi integrācijai?

Pievienojiet „Studio“ savai veikala vitrīnai.

Izveidojiet pārdošanas kanālu, lai ģenerētu savas atslēgas un jau šodien integrētu Studio. Vajadzīga palīdzība notikumu vai pasūtījumu plūsmas konfigurēšanā? Sazinieties ar risinājumu inženieri — atbilde tiks sniegta vienas darbdienas laikā.

Sazinieties ar risinājumu inženieri Izlasiet integrācijas rokasgrāmatu