נתיב רשתות המזון בארץ

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

GET/stores/chains

מחזיר מערך של רשתות. לכל רשת מוחזרים מזהה רשת, שם רשת, ומספר הסניפים המשויך לה (storeCount).

Query params

לנתיב הזה אין פרמטרים, אין pagination, והוא מחזיר את כל הרשתות בבת אחת.

דוגמת בקשה

curl "https://api.priceil.dev/stores/chains"

דוגמת תשובה (data)

[
    {
        "chainId": "7290027600007",
        "chainName": "שופרסל",
        "storeCount": 280
    },
    {
        "chainId": "7290058140886",
        "chainName": "רמי לוי שיווק השקמה",
        "storeCount": 60
    }
]

בפועל, כמו בשאר המערכת, התשובה עטופה במעטפת success/data/timestamp המתוארת בדף הסקירה הראשי.

השדות שבתשובה

שדה	סוג	תיאור
chainId	מחרוזת	מזהה רשמי של הרשת.
chainName	מחרוזת	שם רשת קריא למשתמש להצגה ב-UI.
storeCount	מספר	מספר הסניפים המשויכים לרשת בזמן הבקשה.

שגיאות נפוצות

סטטוס	משמעות	פעולה מומלצת
429	חריגה ממגבלת קצב	retry עם backoff אקספוננציאלי.
500	שגיאת שרת	הציגו fallback ידידותי ונסו שוב מאוחר יותר.