נתיב הסניפים ברשתות במזון

נתיבים לשליפת רשימת סניפים, סינון לפי עיר ורשת, ושליפת סניף בודד עם פרטי הרשת שלו. לרשימת הרשתות עצמן ראו את עמוד הרשתות.

GET/stores

מחזיר רשימה מדורגת של סניפים. אפשר לסנן לפי עיר ו/או שם רשת. כל סניף כולל אובייקט רשת מקונן.

Query params

תומך ב-page ו-limit. ברירת מחדל: page=1, limit=20.

פרמטרים אפשריים

שדה	סוג	נדרש	תיאור
city	מחרוזת	לא	סינון לפי שם עיר או שם סניף (partial match).
chain	מחרוזת	לא	סינון לפי שם רשת (partial match).
page	מספר	לא	מספר עמוד. ברירת מחדל: 1.
limit	מספר	לא	תוצאות לעמוד. ברירת מחדל: 20.

דוגמת בקשה

curl "https://api.priceil.dev/stores?city=תל%20אביב&chain=שופרסל&limit=5"

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

{
  "items": [
    {
      "id": 12,
      "chainId": "7290027600007",
      "subchainId": "1",
      "storeId": "5",
      "subchainName": "שופרסל",
      "storeName": "שופרסל דיל",
      "storeType": 1,
      "address": "דיזנגוף 50",
      "city": "תל אביב",
      "zipcode": "6100000",
      "bikoretNo": 100,
      "lastUpdateDate": "2026-03-20",
      "latitude": "32.0853000",
      "longitude": "34.7817600",
      "chain": {
        "chainId": "7290027600007",
        "chainName": "שופרסל"
      }
    }
  ],
  "total": 7,
  "page": 1,
  "limit": 5
}

נסו בעצמכם

GET?

שדות תגובה — Store

שדה	סוג	תיאור
id	מספר	מזהה פנימי של הסניף במסד הנתונים.
chainId	מחרוזת	מזהה רשמי של הרשת.
subchainId	מחרוזת	מזהה תת-רשת.
storeId	מחרוזת	מזהה הסניף כפי שמדווח על-ידי הרשת.
subchainName	מחרוזת	שם תת-הרשת (לרוב שם הרשת הפנימי).
storeName	מחרוזת	שם הסניף לתצוגה.
storeType	מספר	סוג הסניף (קוד מספרי).
address	מחרוזת	כתובת הסניף.
city	מחרוזת	עיר הסניף.
zipcode	מחרוזת	מיקוד.
lastUpdateDate	מחרוזת (תאריך)	תאריך עדכון אחרון של נתוני הסניף.
latitude	מחרוזת (עשרוני)	קו רוחב גאוגרפי.
longitude	מחרוזת (עשרוני)	קו אורך גאוגרפי.
chain.chainId	מחרוזת	מזהה רשת (מקונן).
chain.chainName	מחרוזת	שם רשת (מקונן).

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

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

טיפ לשימוש

הפרמטר city מסנן גם לפי שם סניף (storeName), לא רק לפי שם עיר. מיון ברירת מחדל: לפי chainName ואז city. כדי לבנות תפריט סינון מלא, שלבו קודם קריאה ל- /stores/chains לשליפת כל הרשתות.

GET/stores/:id

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

Path param

id — המזהה הפנימי של הסניף (מספר שלם).

אין Query params

הנתיב לא תומך בפרמטרים נוספים.

דוגמת בקשה

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

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

{
  "id": 12,
  "chainId": "7290058140886",
  "subchainId": "1",
  "storeId": "5",
  "subchainName": "רמי לוי",
  "storeName": "רמי לוי תל אביב",
  "storeType": 1,
  "address": "רחוב הרצל 1",
  "city": "תל אביב",
  "zipcode": "6100000",
  "bikoretNo": 100,
  "lastUpdateDate": "2026-03-20",
  "latitude": "32.0853000",
  "longitude": "34.7817600",
  "chain": {
    "chainId": "7290058140886",
    "chainName": "רמי לוי שיווק השקמה"
  }
}

נסו בעצמכם

GET

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

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

טיפים לשימוש

לבניית חיפוש חנויות מלא: קראו תחילה ל-/stores/chainsלשליפת רשימת הרשתות, ואז השתמשו ב-chainName כפרמטר לסינון.
שמרו את ה-id (המזהה הפנימי) של הסניף — זהו הערך שתשתמשו בו בנתיבי מוצרים כמו /products/search?storeId=....
latitude ו-longitude הם מחרוזות עשרוניות. המירו ל-float לפני חישוב מרחקים.
הנתיב /stores מסנן עם ILIKE — חיפוש חלקי שאינו תלוי רישיות. אין צורך בהתאמה מלאה לשם.
lastUpdateDate מעדכן לפי התאריך האחרון שבו הרשת דיווחה על עדכון לסניף, לא תאריך עדכון מחירים.