לדלג לתוכן הראשי

איך משתמשים ב-API של מוצרים

אחרי שיש טוקן Bearer — איך קוראים, יוצרים ומעדכנים מוצרים מול api.istores.co.il לפי התיעוד הציבורי.

אחרי שיש לכם טוקן Bearer מפרופיל החברה, אפשר לקרוא, ליצור ולעדכן מוצרים מול https://api.istores.co.il לפי התיעוד הציבורי ב־apidocs.

שלב 1: טוקן ופרופיל החברה

בממשק הניהול פותחים פרופיל → פרופיל החברה (כתובת /client/settings/company), גוללים לכרטיס BEARER טוקן, ומעתיקים את טוקן Bearer. לפירוט המסך ראו גם את מאמר הטוקן.

שלב 2: תיעוד Products

פותחים את https://apidocs.istores.co.il/api/products (ויש גם מבוא לאימות). שם מופיעים הנתיבים והשדות המלאים — אל תנחשו שדות שלא מופיעים בתיעוד.

שלב 3: כותרות חובה בכל בקשה

  • User-Agent — חובה; בקשה בלי User-Agent תקין עלולה להידחות.

  • Company-Id — מזהה הלקוח / שם הספק לפי מה שמוגדר אצלכם.

  • AuthorizationBearer <הטוקן> (מומלץ במקום x-token שיוצא משימוש).

  • Content-Typeapplication/json בבקשות עם גוף.

שלב 4: פעולות מוצרים נפוצות

  1. רשימה: GET /products/{limit}/{page}limit בין 1 ל־200.

  2. מוצר בודד: GET /products/{product_id}.

  3. יצירה: POST /products — בגוף חובה אובייקט product_description (לפי התיעוד).

  4. עדכון: PUT /products/{product_id} — שדות כמו sku, price, quantity, status, product_category ועוד לפי התיעוד.

  5. מחיקה: DELETE /products/{product_id}.

  6. עריכה מרובה: PUT /products/bulk עם product_id ועדכון quantity ו/או price.

מגבלת קצב

ה־API מוגבל ל־2 בקשות לשנייה (עד 120 לדקה). אם עוברים את המגבלה מתקבלת תשובת 429 עם Retry-After — ממתינים לפי הכותרת ורק אז שולחים שוב.

מאמרים קשורים

האם קיבלת תשובה לשאלתך?