Pinakamabilis na landas
SPREEAI para sa mga developer
Gumawa ng fitting room
sa bawat screen.
Ikonekta ang iyong katalogo. Hubugin ang karanasan ng customer. Dalhin ang Always On sa iyong storefront gamit ang integration path na akma sa iyong team.
Piliin ang iyong landas
Magsimula kung saan ang iyong
buhay ng stack ng komersyo.
Gamitin ang Shopify para sa isang pinamamahalaang setup, o i-integrate ito sa aming mga SDK at API. Piliin ang mga feature na kailangan ng iyong negosyo at panatilihin ang shopping journey ng iyong brand.
Pasadyang web
Web SDK
Kontrolin ang paglalagay, estilo, mga kaganapan, laki at gawi sa pagdaragdag sa cart.JavaScript + TypeScript Mga DokumentoKatutubong mobile
iOS SDK
Dalhin ang karanasang SPREEAI sa isang kasalukuyang karanasan sa pamimili gamit ang iOS.Buksan ang gabay sa iOS Mga DokumentoKatutubong mobile
Android SDK
Isama ang try-on sa isang karanasan sa produktong Android gamit ang mga native na kontrol.Buksan ang gabay sa Android Pag-access sa kasosyoMga pasadyang sistema
Mga Pampublikong API
Gamitin ang aprubadong API reference para sa mga server-side at catalog workflow.Bukas na sanggunian ng APIPamilihan
Network ng Kasosyo sa Amazon
Malapit na itong ilabas sa Amazon Partner Network at iba pang mga platform, na may mas maraming paraan para maisama ang SPREEAI sa iyong commerce stack.Dito unang lalabas ang mga updateMabilisang pagsisimula ng Web SDK
Ang iyong unang pagsasama.
Mag-authenticate nang isang beses, pagkatapos ay i-render ang try-on o sizing kahit saan sa page. Gamitin ang mga test credential na ibinigay noong onboarding at huwag kailanman maglagay ng client secret sa browser code.
npm install @spreeai/web-sdk@3.0.0
# or
yarn add @spreeai/web-sdk@3.0.0import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";
// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}// Pass events inside renderTryOnButton's options.
await sdk?.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
events: {
onTryOnButtonClick: (event) => {
console.info(event.name);
},
onAddToCartClicked: (event) => {
// Connect event.garments to your storefront's cart.
},
},
});Ang modelo ng integrasyon
Apat na sistema.
Isang sandali ng kostumer.
Mga Product ID, mga variant, koleksyon ng imahe, at konteksto ng merchandising.
Ang mga kasuotan ay dumadaan sa mga estado ng pagproseso, pagsusuri, at kahandaan.
Hinihiling ng iyong storefront ang karanasan para sa isang kwalipikadong produkto.
Subukan, maghanap ng sukat, kumpletuhin ang hitsura at ibalik sa checkout.
Isang nakapokus na landas para sa paglulunsad
Maghanda. Kumonekta.
Mamuhay nang may kumpiyansa.
Tatlong mahahalagang pangyayari, na may praktikal na checklist para sa bawat isa.
- 01 · Maghanda
Isang malinaw na panimulang punto.
Ihanay ang paglalakbay, pag-access, at katalogo.
Talaan ng paghahanda
- Pumili ng isang channel, grupo ng katalogo, at sukatan ng tagumpay.
- Kumpirmahin ang access ng partner, mga kredensyal, at mga pahintulot sa pag-stage.
- Magbigay ng malinis at naaayon sa SKU na imahe ng damit.
- 02 · Kumonekta
Gawin itong parang katutubo.
Dagdagan ang pagtatanghal. Subukan ang buong paglalakbay.
Tskribi ng integrasyon
- I-render para sa mga kwalipikadong produkto at ikonekta ang mga variant at gawi sa cart.
- Itugma ang karanasan sa tatak.
- Suriin ang mga estado ng mobile, desktop, accessibility, performance, at mga pagkabigo.
- 03 · Paglulunsad
Matuto mula sa totoong paggamit.
Paganahin ang mga handa nang produkto at sukatin.
Checklist ng paglulunsad
- Kumpirmahin ang kahandaan ng produkto at i-publish ang naka-stage na karanasan.
- Subaybayan ang pag-aampon, pagkumpleto, at conversion.
- Gamitin ang mga resulta upang gabayan ang susunod na kategorya o paglalakbay.
Baseline ng asset
Ang mahusay na input ay nagdudulot ng mas mahusay na resulta.
- JPEG o PNG
- Minimum na 2,000 × 2,000 px
- Kinakailangan ang harapang tanaw
- Inirerekomenda ang tanaw sa likod
- Neutral, pantay na ilaw
- SKU o style ID sa pangalan ng file
Sanggunian ng developer
Hanapin ang susunod
kapaki-pakinabang na sagot.
Magsimula rito
Pagsisimula
Unawain ang access, mga sinusuportahang platform, at ang mga unang desisyong kailangang gawin ng iyong team.
Opisyal na sanggunian Pinamamahalaang integrasyonShopify onboarding
I-install ang app, tanggapin ang mga kasunduan, i-sync ang mga damit, i-customize ang button at mag-live.
Opisyal na sanggunian Web SDKIbabaw ng API
Suriin ang pagsisimula, mga opsyon sa pag-render, laki, pagpapasadya at mga naka-type na interface.
Opisyal na sanggunian API ng KasosyoSanggunian ng pampublikong API
Suriin ang aprubadong server-side interface na available sa mga na-authenticate na partner.
Sanggunian ng Swagger KalidadMga ari-arian ng damit
Maghanda ng mga imahe at metadata ng produkto na maayos na dumadaan sa proseso ng pag-intake at pagsusuri.
Gabay sa SPREEAI ProduksyonQA at paglulunsad
Gamitin ang shared browser, performance, accessibility, at go-live checklist.
Gabay sa SPREEAI SuportaPag-troubleshoot
Lutasin ang mga pinakakaraniwang isyu sa pagpapatotoo, pagiging karapat-dapat, pag-render, at pagganap.
Gabay sa SPREEAI DokumentasyonMga gabay sa pagpapatupad
Mag-browse ng mga pampublikong quickstart, mga pamantayan ng asset, mga checklist sa paglulunsad, at gabay sa pag-troubleshoot.
Bukas na dokumentasyonWalang tumutugmang mga mapagkukunan ng developer. Subukan ang “Shopify,” “SDK,” “assets,” o “QA.”
Itayo para sa produksyon
Ang mga detalyeng nagpoprotekta
ang karanasan ng kostumer.
Seguridad
Panatilihing lihim ang server-side, gamitin lamang ang mga inisyu na environment at i-rotate ang mga credential sa workflow ng partner.
Pagkapribado
Humingi ng koleksyon ng imahe ng customer nang may malinaw na pahintulot at iayon ang pagproseso ng data sa iyong inaprubahang plano sa integrasyon.
Pagganap
I-load ang karanasan kung saan ito kinakailangan, subukan ang mga totoong device at subaybayan ang mga regresyon sa pahina ng produkto.
Pagiging Naa-access
Panatilihin ang access sa keyboard, pagkakasunod-sunod ng focus, mga pangalang naa-access, at isang magagamit na path kapag hindi available ang karanasan.
Mga Madalas Itanong (FAQ) para sa Developer
Mga tanong bago
ang unang pangako.
Aling integrasyon ang dapat nating piliin?
Gamitin ang Shopify App para sa pinakamabilis na pinamamahalaang path, ang Web SDK para sa custom o headless web placement, ang mga native SDK para sa mga karanasan sa app, at ang inaprubahang API reference para sa mga server-side workflow na napagkasunduan noong onboarding.
Saan nanggagaling ang mga kredensyal?
Ang SPREEAI ay nagbibigay ng partner ID at mga inaprubahang kredensyal habang onboarding. Gumagamit ang browser SDK ng client ID at partner ID. Huwag kailanman mag-embed ng client secret sa front-end code.
Kailangan ba ng Shopify App ang mga API key?
Ang kasalukuyang daloy ng onboarding ng app na Shopify ay nagkokonekta sa tindahan pagkatapos ng mga kinakailangang kasunduan at hakbang sa subscription; hindi na kailangan ng pinamamahalaang app na kopyahin ang mga key papunta sa setup screen.
Bakit hindi lumalabas ang button na Try-On?
Kumpirmahing nakumpleto na ang pagproseso ng damit, naka-enable na para sa Try-On, naka-map sa aktibong produkto o variant, at kung ang app block o SDK container ay nasa template ng produkto.
Aling mga kaganapan para sa kliyente ang available?
Sakop ng mga dokumentadong SDK callback ang mga pag-click sa Try-On button at mga add-to-cart interaction. Ikonekta ang mga ito sa iyong analytics layer nang hindi isinasama ang imahe ng customer o hindi kinakailangang personal na data.
Mayroon bang mga server webhook na magagamit?
Ang mga server-push webhook ay hindi bahagi ng kasalukuyang nailathalang dokumentasyon ng SDK. Sakupin ang anumang kinakailangan sa server-side event kasama ang Partner Engineering bago ito gamitin.
Saan kumukuha ng tulong ang mga developer?
Gamitin ang path ng teknikal na suporta na ibinigay habang onboarding o email support@spreeai.comIsama ang environment, product ID, browser o device, timestamp at isang maigsi na reproduction path—huwag magpadala ng mga sikreto.
Kailan magiging available ang suporta para sa Amazon Partner Network?
Kasalukuyang binubuo ang integrasyon ng Amazon Partner Network. Sinadya itong markahan bilang "Malapit Na" hanggang sa maging handa na ang onboarding at production interface para sa mga external developer.
Handa nang magtayo?