מונח באיקומרס

Storefront API

Storefront API הוא ה-GraphQL API הציבורי של Shopify (שופיפיי) שמיועד לקריאת נתוני קטלוג ועגלה מתוך חזיתות מותאמות אישית — אפליקציות מובייל, headless storefronts או אתרים שנכתבו ב-Next.js / Hydrogen.

בניגוד ל-Admin API שדורש סודות חזקים וגישה מלאה לחנות, Storefront API מקבל public access token שמיועד לרוץ בדפדפן או באפליקציית מובייל. הוא מוגבל בכוונה לפעולות שלקוח קצה יכול לעשות: לקרוא מוצרים פעילים, להוסיף לעגלה, ליצור Checkout. את הנתונים הוא מחזיר ב-GraphQL — בקשה אחת יכולה להחזיר בדיוק את השדות שצריך בלי overfetch.

בחנות ישראלית headless שבנויה על Storefront API חשוב לזכור שני דברים: השפה והמטבע נקבעים על ידי context שמועבר בכל בקשה (`@inContext(country: IL, language: HE)`), וה-Checkout עדיין רץ אצל Shopify — אי אפשר "להחליף" את הקופה ב-React מותאם, רק לעטוף אותה. זו גם הסיבה ש-PCI נשאר באחריות Shopify גם בארכיטקטורת headless.

מונחים קשורים

A

Access token

אפליקציות ופיתוח

אסימון גישה

Access token הוא הסוד שאפליקציה משתמשת בו כדי לבצע קריאות API בשם חנות Shopify (שופיפיי) — הוא נוצר בסיום זרימת OAuth ותקף עד שהסוחר מסיר את האפליקציה.

API

אפליקציות ופיתוח

ממשק תכנות יישומים

API (Application Programming Interface) הוא ממשק שמאפשר לאפליקציות ולמערכות חיצוניות לתקשר עם Shopify (שופיפיי) — לקרוא נתונים ולעדכן אותם.

API scopes

אפליקציות ופיתוח

היקפי API

API scopes הם היקפי הרשאה שמגדירים אילו נתונים ופעולות אפליקציה יכולה לעשות דרך Shopify API (שופיפיי API) — `read_products`, `write_orders` וכו׳.

C

Custom storefronts

מושגים כלליים

חנות מותאמת אישית

Custom storefront הוא חזית חנות שנבנתה מחוץ למנוע התבניות הרגיל של Shopify (שופיפיי) — אתר React, אפליקציית מובייל או ממשק headless שמושכים נתונים ישירות דרך Storefront API.

W

Webhook

אפליקציות ופיתוח

וובהוק

Webhook (וובהוק) הוא קריאת HTTP יזומה ש-Shopify (שופיפיי) שולחת לכתובת חיצונית ברגע שאירוע קורה בחנות — למשל הזמנה חדשה, עדכון מלאי או ביטול לקוח — בלי שהאפליקציה החיצונית תצטרך לסקור (poll) את ה-API.

עוד מהמילון

A

Access token

API

API scopes

C

Custom storefronts

W

Webhook