אחרי שיש לכם טוקן 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 — מזהה הלקוח / שם הספק לפי מה שמוגדר אצלכם.
Authorization —
Bearer <הטוקן>(מומלץ במקום x-token שיוצא משימוש).Content-Type —
application/jsonבבקשות עם גוף.
שלב 4: פעולות מוצרים נפוצות
רשימה:
GET /products/{limit}/{page}—limitבין 1 ל־200.מוצר בודד:
GET /products/{product_id}.יצירה:
POST /products— בגוף חובה אובייקט product_description (לפי התיעוד).עדכון:
PUT /products/{product_id}— שדות כמוsku,price,quantity,status,product_categoryועוד לפי התיעוד.מחיקה:
DELETE /products/{product_id}.עריכה מרובה:
PUT /products/bulkעםproduct_idועדכוןquantityו/אוprice.
מגבלת קצב
ה־API מוגבל ל־2 בקשות לשנייה (עד 120 לדקה). אם עוברים את המגבלה מתקבלת תשובת 429 עם Retry-After — ממתינים לפי הכותרת ורק אז שולחים שוב.


