דילוג לתוכן
אומת

שגיאות

מה אומר code שלילי, ואיך הוא מתורגם לסטטוס ה-HTTP שאתם רואים בפועל.

כל שיטה עונה { code, data }. code > 0 הוא הצלחה. code < 0 הוא שגיאה, ו-data הוא כמעט תמיד הודעה קריאה שאפשר להציג או לרשום ישירות.

סטטוס ה-HTTP שאתם רואים הוא לא כל הסיפור

CPI ממפה code שלילי לסטטוס HTTP בכלל אחד: קוד מ--400 עד -499 הופך לאותו סטטוס בדיוק (-404 עונה HTTP 404, -409 עונה HTTP 409, -428 עונה HTTP 428). כל קוד שלילי אחר, -1, -500, -762, -999, כל מה שמחוץ לטווח הזה, עונה HTTP 400 רגיל. הפרטים האמיתיים תמיד בגוף ה-JSON, ולכן מפצלים לפי code ולא לפי סטטוס ה-HTTP לבדו. -1 ו--999 נראים זהים בשכבת ה-HTTP ושונים מאוד בגוף.

json
{ "code": -1, "data": "account_not_found" }

קודים שכדאי לפצל לפיהם

מעבר לטבלה הזאת, מיקרו-שירותים בודדים משתמשים בקודים שליליים קטנים משלהם למצבים ייחודיים למודול (קודי חשבון וחיוב בטווח ה--90, התנגשויות ב-Drive סביב -762/-764, קודי מסד נתונים סביב -450/-460, ועוד). הם תמיד מגיעים עם הודעת data תיאורית, קוראים את ההודעה ואת השיטה שקראתם לה ולא את המספר לבדו.

שגיאות בשכבת ה-MCP

בקשה שנכשלת לפני שהרצה שיטה כלשהי, מפתח שגוי או חסר, הודעת MCP פגומה, עונה בשגיאת JSON-RPC במקום מעטפת { code, data }:

json
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" }, "id": null }

ראו MCP. ברגע שקריאה לכלי מגיעה בפועל לשיטה, התוצאה שלה נושאת את מעטפת { code, data } הרגילה בתוך תגובת ה-MCP, בדיוק כמו קריאת REST רגילה.

הצעד הבא