خطاهای سمت کاربر
- 400 Bad Request
- توضیح : سرور نمیتواند درخواست را به دلیل یک خطای مشتری پردازش کند (مثلاً نحو درخواست نادرست، قاببندی پیام نامعتبر، یا مسیر یابی فریبنده).
- دلایل:
- خطاهای نحو در درخواست
- پارامترهای اجباری مفقود شده
- قالبهای داده نامعتبر
- 401 Unauthorized
- توضیح : مشتری باید احراز هویت شود تا بتواند پاسخ درخواست شده را دریافت کند.
- دلایل:
- مدارک احراز هویت مفقود یا نامعتبر
- توکنهای منقضی شده
- 403 Forbidden
- توضیح : مشتری حق دسترسی به محتوا را ندارد؛ یعنی مجاز نیست.
- دلایل:
- عدم دسترسی کافی
- محدودیتهای آدرس IP
- 404 Not Found
- توضیح : سرور نمیتواند منبع درخواست شده را پیدا کند.
- دلایل:
- آدرس URL نادرست
- منبع وجود ندارد
- 405 Method Not Allowed
- توضیح : روش درخواست توسط سرور شناخته شده است اما غیرفعال شده و نمیتواند استفاده شود.
- دلایل:
- استفاده از روشی (مثلاً POST) که توسط نقطه پایانی مجاز نیست
- 406 Not Acceptable
- توضیح : سرور نمیتواند پاسخی که با لیست مقادیر قابل قبول تعریف شده در هدرهای مذاکره محتوا درخواستی تطابق دارد، تولید کند.
- دلایل:
- درخواست یک نوع رسانه غیرپشتیبانی شده
- 408 Request Timeout
- توضیح : سرور در انتظار درخواست، زمان خود را از دست داده است.
- دلایل:
- اتصالات کند یا قطع شده مشتری
- 409 Conflict
- توضیح : درخواست نمیتواند به دلیل تضاد با وضعیت فعلی منبع کامل شود.
- دلایل:
- تضاد دادهها (مثلاً ورودیهای تکراری)
- 410 Gone
- توضیح : منبع درخواست شده دیگر در سرور موجود نیست و هیچ آدرس انتقالدهندهای شناخته شده نیست.
- دلایل:
- منابع دائماً حذف شده
- 413 Payload Too Large
- توضیح : موجودیت درخواست بزرگتر از محدودیتهای تعریف شده توسط سرور است.
- دلایل:
- آپلود فایلهای بزرگ
- 414 URI Too Long
- توضیح : URI ارائه شده برای سرور خیلی طولانی بود که بتواند پردازش کند.
- دلایل:
- URLهای بیش از حد طولانی
- 415 Unsupported Media Type
- توضیح : فرمت رسانهای دادههای درخواستی توسط سرور پشتیبانی نمیشود.
- دلایل:
- فرمتهای فایل غیرپشتیبانی شده
- 429 Too Many Requests
- توضیح : کاربر تعداد زیادی درخواست در زمان معین ارسال کرده است.
- دلایل:
- محدودیتهای نرخ
این خطاها به توسعهدهندگان و کاربران نهایی کمک میکنند تا مشکلاتی که ممکن است در سمت کلاینت ایجاد شود را تشخیص دهند و برای رفع آنها اقدام کنند.
نمونه کد