# שימושים ל-API של מסחר: שבעה דברים שאי אפשר לבנות עם ווידג'ט

> מתי ווידג'ט חנות הוא לא הצורה הנכונה: מסחר מוטמע ב-SaaS, קטלוגים רב-משטחיים, חנויות מיתוג לבן, חוויית משתמש מותאמת, סוכני AI ו-BI מותאם. כולל דוגמאות קוד מה-SDK של Shoprocket.

Ryan Badger - 4 באוגוסט 2025 - 5 דקות קריאה

## למה משמש API של איקומרס להטמעה

רוב פלטפורמות האיקומרס נותנות לך ווידג'ט. מדביקים סקריפט, מקבלים חנות. עובד מצוין ל-95% מהחנויות.

API של מסחר הוא מה שמושיטים אליו יד כשרוצים לעשות משהו שווידג'ט לא עושה: להציג מוצרים בתוך הממשק שלך, להטמיע קופה בתוך דשבורד של SaaS, להפיץ קטלוג על כמה משטחים (אתר + מובייל + קול), או לבנות זרימות קנייה מותאמות שאף פלטפורמה לא מספקת מהקופסה.

Shoprocket מספקת את שניהם. ה[ווידג'ט](https://v3.shoprocket.io/he/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md) הוא ברירת המחדל. ה-[SDK של `@shoprocket/core`](https://github.com/shoprocket/shoprocket-js) הוא למי שגדל מעבר לווידג'ט או בכלל לא היה צריך אותו.

## שימושים שדורשים API ולא ווידג'ט

אלה הבניות שבהן ווידג'ט לא מספיק. אם הרעיון שלך ברשימה, אתה בטריטוריית API.

### 1. מסחר בתוך מוצר ה-SaaS שלך

לדשבורד ה-SaaS שלך כבר יש ממשק משלו. אתה רוצה שלקוחות יקנו תוספים, חבילות קרדיטים, דרגות פרימיום או מרצ'נדייז פיזי בלי לצאת מהאפליקציה.

ווידג'ט יהיה הצורה הלא נכונה: הוא לא מכיר את המשתמשים שלך, לא מתאים למערכת העיצוב שלך, ומניח חנות בעמוד שלם. ה-API מאפשר לך להציג כרטיסי מוצר עם הרכיבים שלך, לקרוא ל-`cart.addItem()` בלחיצה, ולפתוח פאנל קופה משלך (או להפנות לקופה מתארחת אם אתה רוצה לדחות את עבודת הציות).

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

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

// הצגת אריחי תוספים בתוך דשבורד ה-SaaS שלך
const addons = await sr.products.list({ category: 'addons' })

// המשתמש לוחץ על הכפתור "הוסף קרדיטים"
await sr.cart.addItem(addon.id, 1)
```

### 2. קטלוג רב-משטחי (אתר + אפליקציה נייטיב + קול + צ'אט)

קטלוג מוצרים אחד, שמוצג אחרת בכל מקום. חנות האתר מציגה פרטי מוצר מלאים, אפליקציית ה-iOS מציגה רשימה קומפקטית, עוזר קולי מתאר פריטים בקול, ואינטגרציית צ'אט עונה עם קישור לקנייה.

כל ארבעת המשטחים קוראים לאותו API. כשאתה מעדכן מחיר מוצר בדשבורד של Shoprocket, כל משטח משקף את זה בשליפה הבאה. בלי סנכרון תוכן לכל משטח.

### 3. חנויות מיתוג לבן / חנויות שותפים

אתה פלטפורמה שבה אנשים אחרים מוכרים את הסחורה שלהם: מרקטפלייס קהילתי, מדריך שותפים, רשת זכיינים עם אתר נפרד לכל סוכן. לכל שותף יש מיתוג משלו, לא שלך.

האתר של כל שותף רץ על המסגרת שלך אבל קורא ל-API של המסחר עם ה-`publicKey` שלו. המוצרים שלו, ההזמנות שלו, התשלומים שלו, הכול תחום לפי חשבון. אף ווידג'ט לא נכנס בין המיתוג שלו לבין הלקוחות.

### 4. חוויית קנייה מותאמת לחלוטין

קונפיגורטורים אינטראקטיביים למוצרים (מחשבים בהרכבה אישית, תכשיטים בהתאמה אישית, רהיטים בהזמנה). מציגי מוצר תלת-ממדיים. גלריות תמונות "קנה את החדר" שבהן לחיצה על פיקסלים בתמונה מוסיפה את המוצר לעגלה. כפתורי הזמנה חוזרת מהירה בתוך אימייל.

הווידג'ט לא יכול לעשות אף אחד מאלה. ה-API יכול. אתה מציג את הממשק שהמעצב שלך חלם עליו; ה-API מטפל במכניקת המסחר שמאחוריו.

### 5. סוכני AI ומסחר סוכנתי

סוכן AI (ChatGPT, Claude, סוכן מותאם) שיכול לדפדף במוצרים ולהשלים רכישות בשם המשתמש. הסוכן צריך גישה תכנותית לקטלוג ולעגלה שלך, לא ווידג'ט DOM שהוא צריך לפענח.

Shoprocket מספקת פידים לפרוטוקולי מסחר של AI לצד גישת API רגילה. סוכן ששואל "מה במלאי מתחת ל-50 דולר עם משלוח חינם" מקבל תשובה מובנית, לא גריפת מסך.

### 6. מסחר מוטמע בכלי תוכן

דף Notion שבו בלוקים אפשר לקנות. עיצוב Framer עם נקודות חמות ללחיצה לרכישה. כלי ניוזלטר שבו מנויים יכולים ללחוץ על כרטיס מוצר ולשלם בלי לצאת מהאימייל. הכול בנוי על גבי API.

### 7. דיווח מותאם ודשבורדים של BI

הדשבורד של Shoprocket מראה הכנסות, המרה, מוצרים מובילים. מה שהוא לא מראה הם המדדים *שלך*: ערך לאורך חיי הלקוח לפי קוהורט, הזמנות לפי מקור הפניה, מרווח אחרי עלות ספק. ה-API חושף נתוני הזמנות ולקוחות כדי שתוכל להזרים אותם לכלי ה-BI שלך, לגיליון או לדשבורד פנימי.

## מה ה-SDK נותן היום

מתוך `@shoprocket/core`:

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

// Cart
sr.cart.get()
sr.cart.addItem(productId, quantity)
sr.cart.updateItem(itemId, quantity)
sr.cart.removeItem(itemId)

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

בנוסף, ה-REST API המלא לכל מה שה-SDK עדיין לא עוטף (הזמנות, לקוחות, הנחות, כתיבת מוצרים). ראה את [api.shoprocket.io/docs](https://api.shoprocket.io/docs) להתייחסות המלאה.

## איפה API-first הוא טעות

כמה מקרים שבהם הווידג'ט הוא הבחירה הנכונה וה-API מוגזם:

- **חנות פשוטה עם 10-200 מוצרים.** הווידג'ט מציג את זה מצוין; לכתוב ממשק קטלוג משלך זה לעשות מחדש עבודה פתורה.
- **אין לך כוח הנדסי ייעודי לפרונטאנד.** API-first דורש שתשלח ותתחזק בעצמך מצבי טעינה, ממשק וריאציות, טיפול בשגיאות, נגישות וi18n ב-21 שפות. אלה שבועות עבודה שהווידג'ט נותן בחינם.
- **החשש העיקרי שלך הוא מהירות השקה.** ווידג'ט זה דקות; API-first זה שבועות לפחות.

ברירת המחדל היא הווידג'ט. תשתמש ב-API כשאתה נתקל במשהו שהווידג'ט לא יכול לעשות.

## פרויקט ראשון מציאותי

הפרויקט הנפוץ ביותר של "אני צריך את ה-API": מוצר SaaS שרוצה למכור קרדיטים, מנויים או תוספים חד-פעמיים בתוך הדשבורד שלו.

הגישה:

1. התקן את `@shoprocket/core` בפרונטאנד שלך
2. צור ב-Shoprocket קטגוריה בשם "תוספים" או דומה
3. הוסף מוצרים עם התמחור / התיאור המדויקים שאתה רוצה
4. הצג את רשימת המוצרים בדשבורד שלך עם ספריית הרכיבים שלך
5. בלחיצה, הוסף לעגלה + הפנה לקופה המתארחת של Shoprocket (או הטמע את הקופה בתוך הדף אם נוח לך עם העבודה הנוספת)
6. הגדר נקודת קצה ל-webhook שתקבל אירועי `order.paid`, כדי שתוכל להפעיל את מה שהרכישה פותחת (קרדיטים, גישה, משלוח)

זהו. קומץ קבצים, יום עבודה למי שרגיל לקרוא ל-API. בלי ווידג'ט, בלי iframe, בלי פשרות על הממשק של המוצר שלך.

## מה אנחנו לא ממליצים

אל תבנה מחדש ממשק קטלוג מלא שדומה מאוד למה שהווידג'ט כבר עושה. אם אתה משקיע שבועות ב"רשת מוצרים עם מסננים וחיפוש", אתה כותב את מה שהווידג'ט מספק בדקות. השתמש בווידג'ט לצורה הזו, וב-API לצורות שבאמת שונות.

> **טיפ:** אם אתה שוקל ללכת על API-first כי העיצוב ברירת המחדל של הווידג'ט לא מתאים למותג שלך, נסה קודם את [ווי העיצוב של הווידג'ט](https://github.com/shoprocket/shoprocket-js). הווידג'ט מקבל הרבה יותר התאמות CSS ממה שנראה. בנייה מחדש מלאה על ה-API היא משימה כבדה בהרבה.

## בקצרה

- **ווידג'ט** = ברירת מחדל, מכסה 95% מהחנויות
- **API / SDK** = כשהווידג'ט הוא לא הצורה הנכונה (מסחר מוטמע ב-SaaS, רב-משטחי, מיתוג לבן, חוויה מותאמת, סוכני AI, BI מותאם)
- **משטח ה-SDK היום:** מוצרים, עגלה, סשנים; בנוסף REST API מלא להזמנות / לקוחות / הנחות
- **תבנית הפרויקט הראשון:** דשבורד SaaS שמוכר קרדיטים או תוספים דרך SDK + הפעלה מבוססת webhook
- **אל תבנה מחדש על ה-API** את מה שהווידג'ט כבר עושה טוב; בחר את הצורה שלך

[התחל תקופת ניסיון חינם](https://app-v3.shoprocket.io/signup) וקח מפתח ציבורי; ה-SDK חינם לשימוש בכל תוכנית של Shoprocket. 14 יום, בלי כרטיס.

---

- HTML version: https://v3.shoprocket.io/he/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget
- Language: עברית (he)
- 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/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), [Lietuvių](https://v3.shoprocket.io/lt/tinklarastis/prekybos-api-panaudojimo-atvejai-septyni-sprendimai-kuriu-nepadarysite-su-valdykle.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)