با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
Classroom API اطلاعات خطا را برمیگرداند که میتواند به توسعهدهندگان کمک کند مشکلات را اشکالزدایی کنند و اطلاعات مفید و کاربردی را به کاربران نهایی ارائه دهند. این راهنما نحوه تجزیه اطلاعات خطای بازگشتی از API را توضیح می دهد.
Classroom API دو سطح از اطلاعات خطا را برمی گرداند:
کد خطای HTTP در هدر.
یک شی در بدنه پاسخ با جزئیات اضافی.
ساختار پیام خطا
خطاهای بازگشتی در بدنه پاسخ شامل فیلدهای زیر است:
code : کد خطای عددی HTTP. به عنوان مثال، 403 .
message : جزئیات بیشتر در مورد خطا. در صورت موجود بودن، پیام خطا با @ و یک نوع خطای خاص اضافه می شود. به عنوان مثال، @ClassroomApiDisabled .
status : وضعیت درخواست HTTP. به عنوان مثال، PERMISSION_DENIED یا NOT_FOUND .
اگر درخواستی با خطای ClassroomApiDisabled ناموفق بود، پاسخ به این صورت خواهد بود:
{"error":{"code":403,"message":"@ClassroomApiDisabled The user is not permitted to access the Classroom API.","status":"PERMISSION_DENIED"}}
می توانید از بدنه پاسخ برای کمک به رفع اشکال علت خطا و ارائه اطلاعات مفید به کاربران استفاده کنید. برای جلوگیری از تطبیق مقادیر دیگر که با همان رشته شروع می شوند، یک فضای انتهایی را هنگام بررسی یک پیام خطای خاص اضافه کنید. در مثال خطای ارائه شده، می توانید بررسی کنید که آیا فیلد پیام با "@ClassroomApiDisabled " شروع می شود تا اطلاعات مناسب را به کاربران ارائه دهید.
برای اطلاعات در مورد برخی از خطاهایی که می تواند توسط Classroom API برگردانده شود، به صفحه خطاهای رایج مراجعه کنید.
تاریخ آخرین بهروزرسانی 2025-01-28 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-01-28 بهوقت ساعت هماهنگ جهانی."],[[["The Classroom API provides error information via HTTP error codes in the header and detailed error objects in the response body."],["Error objects in the response body contain a numerical `code`, a detailed `message` potentially including a specific error type prepended with `@`, and an HTTP request `status`."],["Developers can use the error `message` field, particularly by checking for specific prefixes like `@ClassroomApiDisabled `, to debug issues and inform users."],["The error message structure provided by the API allows for the extraction of the HTTP code, the reason behind the error and its status."],["Refer to the Common Errors page to see a detailed list of possible error messages and the actions that can be taken in response to them."]]],[]]