המאמר הזה מסביר בקצרה מה זה API, איך ה־API של mypips עובד, איך מנהל/ת חנות יוצרים מפתח API, ולמי כדאי לצלול לתוך הדוקומנטציה המלאה.
💡 למי זה מתאים?
מנהלי חנות שרוצים להבין מה אפשר לעשות עם API ולפתוח חיבור למערכת חיצונית, ומפתחים ושותפים טכנולוגיים שרוצים לחבר מערכת חיצונית ל־mypips.
מה זה API?
API (קיצור של Application Programming Interface) הוא הדרך שבה שתי תוכנות מדברות אחת עם השנייה. במקום שאדם יפתח את הממשק וילחץ על כפתורים, התוכנה השנייה שולחת בקשה ישירות ומקבלת תשובה.
דוגמה פשוטה: כשאתם מזמינים אוכל באפליקציה ורואים מפה עם מיקום השליח, האפליקציה מדברת בלי הפסקה עם API של שירות המפות. אתם רואים את התוצאה, היא קורית ברקע.
אפשר לחשוב על API כעל מלצר במסעדה: אתם אומרים לו מה אתם רוצים, הוא הולך למטבח, והוא חוזר עם הצלחת. אתם לא צריכים לדעת איך המטבח עובד מבפנים.
ה־API של mypips
לכל חנות ב־mypips יש API שמאפשר לתוכנות אחרות לעבוד מול הנתונים והפעולות של החנות, באותו אופן שבו אתם עובדים מול הממשק.
אפשר להשתמש בו, לדוגמה, כדי:
למשוך נתונים על הזמנות, מוצרים, לקוחות ומלאי למערכת חיצונית (CRM, BI, מערכת הנהלת חשבונות).
לעדכן מוצרים ומחירים באופן אוטומטי ממערכת ניהול קיימת.
לסנכרן מלאי בין חנויות או מול ספק.
לחבר אוטומציות (Make, Zapier, n8n) לתהליכים פנימיים.
לבנות אינטגרציה ייחודית לעסק שלכם.
🏆 שימו לב! כל פעולה ב־API עוברת את אותן בדיקות הרשאה שעובר משתמש רגיל בממשק. ה־API לא עוקף את ההרשאות, הוא משתמש בהן.
יצירת מפתח API
מפתח API הוא הזיהוי שבעזרתו מערכת חיצונית מתחברת לחנות שלכם. בלי מפתח, אין גישה. מנהל/ת החנות יוצרים את המפתח מתוך הגדרות החנות, ומחליטים בדיוק לאיזה מידע יש לו גישה.
💡 לפני שמתחילים:
רק משתמש עם הרשאת ניהול כללי בחנות יכול ליצור מפתחות. אפשר ליצור עד 5 מפתחות פעילים לכל חנות.
שלב 1: כניסה למסך ניהול המפתחות
היכנסו לחנות שלכם, ועברו ל־הגדרות חנות ומערכת > התממשקויות. תחת הכותרת ניהול מפתחות API תראו את רשימת המפתחות הקיימים בחנות, וכפתור צור מפתח חדש.
שלב 2: יצירת מפתח חדש
לחצו על צור מפתח חדש. בחלון שנפתח, תנו למפתח שם פנימי שיעזור לכם לזהות אותו אחר כך (למשל "Zapier של דנה", "AI Agent", "סנכרון חשבונאות").
השם הזה לא נחשף החוצה, הוא בשבילכם בלבד, כדי שתדעו איזה מפתח שייך לאיזה חיבור.
שלב 3: בחירת הרשאות
לכל מפתח אפשר להגדיר במדויק לאיזה מידע בחנות יש לו גישה, ואם הוא יכול רק לקרוא או גם לעדכן. הרשאה ניתנת לכל סוג משאב בנפרד: לקוחות, הזמנות, מוצרים, מלאי, משלוחים, ספקים, מבצעים וקודי קופון, תוכן, דפים מותאמים, מדיה, ועוד.
חלק מהמשאבים זמינים לקריאה בלבד (תנועות, חשבוניות, מחירונים, דוחות), בגלל הרגישות שלהם.
🏆 שימו לב! כלל אצבע: תנו רק את ההרשאות שהמערכת המחוברת באמת צריכה. אם המערכת רק קוראת נתונים, אל תיתנו לה הרשאות עדכון. ככה גם אם משהו משתבש בצד השני, הנזק האפשרי קטן.
שלב 4: שמירת המפתח
לחצו על צור מפתח. mypips ייצור עבורכם מפתח ייחודי. זה הרגע להעתיק אותו ולשמור אותו במקום בטוח (מנהל סיסמאות, הגדרות המערכת המחוברת). מטעמי אבטחה, את המפתח המלא אפשר לראות רק פעם אחת.
אחרי שיצרתם, ברשימת המפתחות תראו לכל מפתח את התאריך שבו נוצר, את תאריך השימוש האחרון, ואת ההרשאות שניתנו לו.
ניהול שוטף
מתוך אותו מסך, לכל מפתח אפשר:
לערוך את השם וההרשאות שלו.
לצפות בנתוני השימוש ולראות מתי המפתח נוצל ולאילו פעולות.
להשבית או למחוק את המפתח. ברגע שמפתח נמחק, כל מערכת שמשתמשת בו תפסיק לעבוד מולכם, מיד.
🏆 שימו לב! אם יש חשד שמפתח דלף, מחקו אותו מיד וצרו אחד חדש. זה התפקיד של נתוני השימוש: לעזור לכם לזהות מתי משהו לא נראה תקין.
דוקומנטציה למפתחים
הדוקומנטציה המלאה של ה־API מיועדת למפתחים וכוללת את כל הפעולות, הפרמטרים והדוגמאות.
קישור לדוקומנטציה: https://api.mypips.app/docs/api
בדוקומנטציה תמצאו:
רשימת ה־endpoints הזמינים (קריאה וכתיבה).
מבנה הבקשות והתשובות.
איך מתחברים ומאמתים מול ה־API עם המפתח שיצרתם.
דוגמאות לקריאות נפוצות.
⁉️ שאלות נפוצות
1. אני לא מפתח/ת, ה־API רלוונטי לי?
לרוב לא ישירות. אם יש לכם צורך באוטומציה או באינטגרציה, יצרו את המפתח לפי השלבים למעלה, והעבירו אותו (יחד עם הקישור לדוקומנטציה) למפתח/ת או לאיש האינטגרציות שעובד איתכם.
אם אתם מחפשים פתרון בלי קוד, אפשר להתחיל עם החיבור ל־Claude ול־ChatGPT שמאפשר לבצע פעולות בחנות דרך שיחה.
2. השימוש ב־API בטוח?
כן. גישה ל־API דורשת מפתח, ולכל מפתח יש הרשאות מוגדרות. אתם יכולים לראות, לעדכן, להשבית ולמחוק מפתחות בכל רגע מתוך הגדרות החנות.
3. כמה מפתחות אפשר ליצור?
עד 5 מפתחות פעילים בכל חנות. מומלץ ליצור מפתח נפרד לכל מערכת שמתחברת, כדי לזהות בקלות מי מבצע מה ולהשבית רק את מה שצריך אם משהו משתבש.
4. יש עלות לשימוש ב־API?
ה־API זמין ללקוחות mypips ללא תוספת תשלום. יש מגבלות קצב סבירות (rate limits) כדי לשמור על יציבות המערכת. הפרטים המלאים מופיעים בדוקומנטציה.
🏆 טיפ
צריכים עזרה בבניית אינטגרציה? כתבו לנו ונחבר אתכם לחומר המתאים או לאיש הקשר הנכון.
הצטרפו לקהילה שלנו בוואטסאפ, ותהיו הראשונים להתעדכן בכל מה שקורה.