שגיאות
מה אומר 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 ושונים מאוד בגוף.
קודים שכדאי לפצל לפיהם
מעבר לטבלה הזאת, מיקרו-שירותים בודדים משתמשים בקודים שליליים קטנים משלהם למצבים ייחודיים למודול
(קודי חשבון וחיוב בטווח ה--90, התנגשויות ב-Drive סביב -762/-764, קודי מסד נתונים סביב
-450/-460, ועוד). הם תמיד מגיעים עם הודעת data תיאורית, קוראים את ההודעה ואת השיטה שקראתם
לה ולא את המספר לבדו.
שגיאות בשכבת ה-MCP
בקשה שנכשלת לפני שהרצה שיטה כלשהי, מפתח שגוי או חסר, הודעת MCP פגומה, עונה בשגיאת JSON-RPC
במקום מעטפת { code, data }:
ראו MCP. ברגע שקריאה לכלי מגיעה בפועל לשיטה, התוצאה שלה נושאת את מעטפת
{ code, data } הרגילה בתוך תגובת ה-MCP, בדיוק כמו קריאת REST רגילה.