שגיאות
כל תגובת שגיאה (כל סטטוס שאינו 2xx) חוזרת במעטפת אחידה תחת מפתח error, כולל request_id ייחודי — צרפו אותו לפניות תמיכה כדי לאתר את הבקשה בלוגים.
error.json
{
"error": {
"code": "barcode_not_found",
"message": "Product with barcode '0000000000000' not found.",
"request_id": "req_3f9a2c1b8e4d5f60",
"docs_url": "https://savemycart.net/developers/errors#barcode_not_found"
}
}אותו request_id מוחזר גם בכותרת X-Request-Id על כל תגובה — כולל תגובות מוצלחות — כדי לאפשר מעקב קצה-לקצה.
טבלת קודים
| code | סטטוס HTTP | משמעות |
|---|---|---|
| bad_request | 400 | פרמטר חובה חסר או שגוי |
| invalid_api_key | 401 | מפתח API חסר, שגוי או בוטל |
| quota_exhausted | 403 | המכסה החודשית נוצלה במלואה |
| barcode_not_found | 404 | לא נמצא מוצר עם הברקוד שסופק |
| not_covered | 404 | המשאב המבוקש (רשת, חשבון, מפתח) לא נמצא |
| validation_error | 422 | גוף הבקשה לא תקין (שדות חסרים/שגויים) |
| rate_limited | 429 | קצב הבקשות לשנייה חרג מהמותר לתוכנית |
| internal_error | 5xx | שגיאה בלתי צפויה בשרת |