# Prekybos API panaudojimo atvejai: septyni sprendimai, kurių nepadarysite su valdykle

> Kai parduotuvės valdyklė netinkama forma: SaaS įterpta prekyba, kelių paviršių katalogai, baltos etiketės parduotuvės, pritaikyta naudotojo patirtis, DI agentai, pritaikyta BI. Plius kodo pavyzdžiai iš Shoprocket JS SDK.

Ryan Badger - 2025 m. rugpjūčio 4 d. - 5 min. skaitymo

## Kam skirtas el. prekybos API įterpimui

Dauguma el. prekybos platformų duoda valdyklę. Įklijuojate skriptą, gaunate parduotuvę. Puikiai tinka 95 % parduotuvių.

Prekybos API imatės tada, kai norite padaryti tai, ko valdyklė nemoka: atvaizduoti produktus savo sąsajoje, įterpti atsiskaitymą į SaaS skydelį, paskirstyti katalogą keliems paviršiams (internetas + mobilioji programėlė + balsas) arba sukurti pritaikytas pirkėjo eigas, kurių nepateikia jokia platforma.

Shoprocket turi abu. [Valdyklė](https://v3.shoprocket.io/lt/tinklarastis/headless-prekyba-trys-lygiai-ir-kuris-jums-tinka.md) yra numatytasis pasirinkimas. [`@shoprocket/core` SDK](https://github.com/shoprocket/shoprocket-js) skirtas tada, kai išaugate valdyklę arba jos niekada ir nereikėjo.

## Atvejai, kuriems reikia API, o ne valdyklės

Tai sprendimai, kuriems valdyklės neužtenka. Jei jūsų idėja yra šiame sąraše, esate API teritorijoje.

### 1. Prekyba jūsų SaaS produkte

Jūsų SaaS skydelis jau turi savo sąsają. Norite, kad klientai pirktų papildinius, kreditų paketus, aukštesnes pakopas ar fizinius suvenyrus nepalikdami jūsų programos.

Valdyklė būtų netinkama forma: ji nežino jūsų naudotojų, nesuderinta su jūsų dizaino sistema ir tikisi viso puslapio parduotuvės. API leidžia atvaizduoti produktų korteles savo komponentais, paspaudus mygtuką iškviesti `cart.addItem()` ir parodyti savo atsiskaitymo skydelį (arba nukreipti į talpinamą atsiskaitymą, jei norite atidėti atitikties darbą).

```
import { ShoprocketCore } from '@shoprocket/core'

const sr = new ShoprocketCore({ publicKey: 'pk_...' })

// Atvaizduokite papildinių plyteles savo SaaS skydelyje
const addons = await sr.products.list({ category: 'addons' })

// Naudotojas spusteli mygtuką // User clicks "Add credits" buttonquot;Add credits// User clicks "Add credits" buttonquot;
await sr.cart.addItem(addon.id, 1)
```

### 2. Kelių paviršių katalogas (internetas + vietinė programėlė + balsas + pokalbis)

Vienas produktų katalogas, kiekvienoje vietoje atvaizduojamas skirtingai. Interneto parduotuvė rodo pilną produkto informaciją, vietinė iOS programėlė rodo kompaktišką sąrašą, balso asistentas prekes aprašo garsiai, pokalbių integracija atsako pirkimo nuoroda.

Visi keturi paviršiai kreipiasi į tą patį API. Kai Shoprocket skydelyje pakeičiate produkto kainą, kiekvienas paviršius ją atspindi kito gavimo metu. Jokio kiekvieno paviršiaus turinio sinchronizavimo.

### 3. Baltos etiketės / partnerių parduotuvės

Esate platforma, kurioje kiti parduoda savo prekes: bendruomenės prekyvietė, partnerių katalogas, franšizės tinklas su atskirų atstovų svetainėmis. Kiekvienas partneris turi savo, o ne jūsų prekės ženklą.

Kiekvieno partnerio svetainė veikia jūsų karkase, bet kreipiasi į prekybos API su savo `publicKey`. Jų produktai, jų užsakymai, jų išmokos, viskas apribota paskyra. Jokia valdyklė netrukdo jų prekės ženklui.

### 4. Visiškai pritaikyta pirkėjo patirtis

Interaktyvūs produktų konfigūratoriai (pritaikyti kompiuteriai, personalizuotos juvelyrikos, baldai pagal užsakymą). 3D produktų peržiūros. „Apsipirk kambaryje“ nuotraukų galerijos, kur spustelėjus pikselius paveikslėlyje produktas įdedamas į krepšelį. Greito pakartotinio užsakymo mygtukai laiške.

Valdyklė nieko iš to nepadarys. API padarys. Atvaizduojate bet kokią sąsają, kurią sugalvojo jūsų dizaineris; API tvarko už jos esančią prekybos mechaniką.

### 5. DI agentai ir agentinė prekyba

DI agentas (ChatGPT, Claude, pritaikytas agentas), galintis naršyti produktus ir atlikti pirkimus naudotojo vardu. Agentui reikia programinės prieigos prie jūsų katalogo ir krepšelio, o ne DOM valdyklės, kurią jam tektų analizuoti.

Shoprocket kartu su standartine API prieiga pateikia DI prekybos protokolų srautus. Agentui paklausus „kas yra sandėlyje iki $50 su nemokamu pristatymu“, jis gauna struktūrizuotą atsakymą, o ne ekrano nuskaitymą.

### 6. Įterpta prekyba turinio įrankiuose

Notion puslapis, kuriame blokai gali būti perkami. Framer dizainas su spustelėk-ir-pirk taškais. Naujienlaiškių įrankis, kuriame prenumeratoriai gali paliesti produkto kortelę ir sumokėti neišėję iš laiško. Viskas sukurta ant API.

### 7. Pritaikytos ataskaitos ir BI skydeliai

Shoprocket skydelis rodo pajamas, konversiją, populiariausius produktus. Ko jis nerodo, tai *jūsų* pritaikytų rodiklių: kliento gyvavimo vertės pagal kohortą, užsakymų pagal nukreipimo šaltinį, maržos atėmus tiekėjo kainą. API atveria užsakymų ir klientų duomenis, kad galėtumėte juos nukreipti į savo BI įrankį, skaičiuoklę ar vidinį skydelį.

## Ką SDK suteikia šiandien

Iš `@shoprocket/core`:

```
// Products
sr.products.list({ limit, offset, sort, category })
sr.products.get(productId)

// Krepšelis
sr.cart.get()
sr.cart.addItem(productId, quantity)
sr.cart.updateItem(itemId, quantity)
sr.cart.removeItem(itemId)

// Sesija
sr.session.create()
sr.setSessionToken(token)
```

Plius pilnas REST API viskam, ko SDK dar neapgaubia (užsakymai, klientai, nuolaidos, produktų rašymas). Pilną nuorodą žr. [api.shoprocket.io/docs](https://api.shoprocket.io/docs).

## Kur „API pirmiausia“ yra klaida

Keli atvejai, kai valdyklė yra teisingas pasirinkimas, o API per daug:

- **Paprasta parduotuvė su 10-200 produktų.** Valdyklė tai atvaizduoja puikiai; rašyti savo katalogo sąsają reiškia kartoti jau išspręstą darbą.
- **Neturite specialių frontend inžinerijos pajėgumų.** „API pirmiausia“ reikalauja pačiam sukurti ir prižiūrėti įkėlimo būsenas, variantų sąsają, klaidų tvarkymą, prieinamumą, i18n 21 lokalei. Tai savaitės darbo, kurį valdyklė suteikia nemokamai.
- **Jūsų pagrindinis rūpestis yra paleidimo greitis.** Valdyklė yra minutės; „API pirmiausia“ yra bent savaitės.

Pagal nutylėjimą rinkitės valdyklę. Imkitės API, kai susiduriate su tuo, ko valdyklė negali.

## Realistiškas pirmasis projektas

Dažniausias projektas „man reikia API“: SaaS produktas, norintis parduoti kreditus, prenumeratas ar vienkartinius papildinius savo skydelyje.

Požiūris:

1. Įdiekite `@shoprocket/core` savo frontende
2. Sukurkite Shoprocket kategoriją pavadinimu „Add-ons“ ar panašiai
3. Pridėkite produktus su tiksliai norima kaina / aprašymu
4. Atvaizduokite produktų sąrašą savo skydelyje savo komponentų biblioteka
5. Paspaudus pridėkite į krepšelį + nukreipkite į Shoprocket talpinamą atsiskaitymą (arba įterpkite atsiskaitymą tiesiai, jei jaučiatės patogiai su papildomu darbu)
6. Sukonfigūruokite webhook galinį tašką gauti `order.paid` įvykius, kad galėtumėte suteikti tai, ką pirkinys atrakina (kreditus, prieigą, siuntą)

Viskas. Saujelė failų, vienos dienos darbas tam, kas įpratęs kviesti API. Jokios valdyklės, jokio iframe, jokių kompromisų jūsų produkto sąsajai.

## Ko nerekomenduojame

Nekurkite iš naujo viso katalogo sąsajos, kuri labai primena tai, ką valdyklė jau daro. Jei savaitėmis dirbate prie „produktų tinklelio su filtrais ir paieška“, rašote tai, ką valdyklė pateikia per minutes. Tokiai formai naudokite valdyklę, API naudokite iš tiesų skirtingoms formoms.

> **Patarimas:** jei galvojate apie „API pirmiausia“ todėl, kad numatytasis valdyklės stilius nederinasi su jūsų prekės ženklu, pirmiausia išbandykite [valdyklės stiliaus kabliukus](https://github.com/shoprocket/shoprocket-js). Valdyklė priima daug daugiau CSS pritaikymo, nei atrodo. Pilnas API perrašymas yra kur sunkesnis darbas.

## Trumpai

- **Valdyklė** = numatytasis pasirinkimas, tinka 95 % parduotuvių
- **API / SDK** = kai valdyklė netinkama forma (SaaS įterpta prekyba, keli paviršiai, balta etiketė, pritaikyta patirtis, DI agentai, pritaikyta BI)
- **Šiandienos SDK aprėptis:** produktai, krepšelis, sesijos; plius pilnas REST API užsakymams / klientams / nuolaidoms
- **Pirmo projekto modelis:** SaaS skydelis parduoda kreditus ar papildinius per SDK + webhook valdomas suteikimas
- **Nekurkite per API iš naujo** to, ką valdyklė jau gerai daro; rinkitės savo formą

[Pradėkite nemokamą bandomąjį laikotarpį](https://app-v3.shoprocket.io/signup) ir pasiimkite viešąjį raktą; SDK nemokamas bet kuriame Shoprocket plane. 14 dienų, be kortelės.

---

- HTML version: https://v3.shoprocket.io/lt/tinklarastis/prekybos-api-panaudojimo-atvejai-septyni-sprendimai-kuriu-nepadarysite-su-valdykle
- Language: Lietuvių (lt)
- Also in: [العربية](https://v3.shoprocket.io/ar/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Deutsch](https://v3.shoprocket.io/de/blog/commerce-api-anwendungsfaelle-sieben-builds-ohne-widget.md), [Ελληνικά](https://v3.shoprocket.io/el/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [English](https://v3.shoprocket.io/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Español](https://v3.shoprocket.io/es/blog/casos-de-uso-api-de-comercio-siete-proyectos-que-un-widget-no-puede-hacer.md), [Français](https://v3.shoprocket.io/fr/blog/api-commerce-sept-cas-usage-impossibles-avec-un-widget.md), [עברית](https://v3.shoprocket.io/he/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [हिन्दी](https://v3.shoprocket.io/hi/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Bahasa Indonesia](https://v3.shoprocket.io/id/blog/kasus-penggunaan-commerce-api-tujuh-hal-yang-tidak-bisa-dilakukan-widget.md), [Italiano](https://v3.shoprocket.io/it/blog/api-commerce-sette-casi-duso-che-un-widget-non-copre.md), [日本語](https://v3.shoprocket.io/ja/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Norsk](https://v3.shoprocket.io/nb/blogg/handels-api-sju-ting-du-ikke-kan-bygge-med-en-widget.md), [Nederlands](https://v3.shoprocket.io/nl/blog/commerce-api-use-cases-zeven-projecten-zonder-widget.md), [Polski](https://v3.shoprocket.io/pl/blog/api-do-e-commerce-siedem-zastosowan-ktorych-nie-zrobisz-widzetem.md), [Português](https://v3.shoprocket.io/pt/blog/casos-de-uso-api-de-commerce-sete-projetos-que-widget-nao-faz.md), [Română](https://v3.shoprocket.io/ro/blog/cazuri-de-utilizare-api-comert-sapte-proiecte-fara-widget.md), [Русский](https://v3.shoprocket.io/ru/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [ไทย](https://v3.shoprocket.io/th/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Türkçe](https://v3.shoprocket.io/tr/blog/commerce-api-kullanim-senaryolari-widget-ile-yapilamayan-yedi-proje.md), [中文](https://v3.shoprocket.io/zh/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md)