מדריך למפתחים: בניית אפליקציות מעל ה-API של Commegix

כל מה שצריך לדעת כדי לבנות אינטגרציות חכמות ומהירות על בסיס הפלטפורמה שלנו.

ניווט למפתחים:

ארכיטקטורה ואימות (OAuth2)
ניהול עומסים ו-Rate Limiting
עבודה עם Webhooks בזמן אמת
Quick Start ושאלות נפוצות

גישת ה-API-First

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

המבט ההנדסי: נוסחת ניהול עומסים

אנו משתמשים באלגוריתם Token Bucket כדי להבטיח הוגנות ויציבות:

R = B + (r × t)

מנגנון זה מאפשר לכם לבצע Burst Operations של עדכוני מלאי מאסיביים מבלי לפגוע בזמינות הכללית של ה-API.

דוגמת קוד: משיכת מלאי (Inventory Get)

GET /v1/inventory?sku=SH-12345
Authorization: Bearer YOUR_API_KEY
Accept: application/json

השוואה: סנכרון Pull מול Webhooks

מדד	סנכרון Pull (Polling)	סנכרון Webhooks
מהירות עדכון	תלויה בתדירות (ממוצע 15 דק’)	בזמן אמת (< 2 שניות)
יעילות משאבים	נמוכה (צריכת CPU קבועה)	גבוהה מאוד
מורכבות	פשוטה למימוש	דורשת Endpoint מאזין

שאלות נפוצות (FAQ)

1. מהם מגבלות ה-Rate Limit?

מגבלת ברירת המחדל היא 5,000 בקשות בשעה, עם אפשרות להרחבה עבור לקוחות Enterprise הזקוקים לסנכרון קטלוגים ענקיים (ראו שיטות לעבודה עם Bulk SKU).

2. האם ה-API תומך ב-Batch Updates?

כן, ניתן לעדכן עד 500 מק”טים בבקשת JSON אחת כדי לייעל את רוחב הפס וזמן העיבוד.

3. איך מקבלים גישה לסביבת Sandbox?

פנו לצוות התמיכה שלנו במייל dev-support@commegix.co.il ונפתח עבורכם סביבת בדיקות מבודדת תוך פחות מ-24 שעות.