با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
کدهای وضعیت زیر را می توان در پاسخ های HTTP برگرداند.
کد HTTP
توضیحات HTTP
یادداشت
2xx
خوب
خطا نیست؛ با موفقیت بازگشت. این همچنین باید برای شکست های منطق تجاری استفاده شود (مثلا booking_failure در CreateBookingResponse پر شده است)
400
درخواست بد
درخواست بد/ استدلال نامعتبر (تاجر، سرویس، جایگاه پیدا نشد، تلاش برای رزرو یک اسلات نامعتبر، لغو رزروی که هرگز وجود نداشته است).
401
غیرمجاز
احراز هویت نشده (مدارک نامعتبر، دوباره سعی کنید وارد شوید). درخواست دارای اعتبار احراز هویت معتبر برای عملیات نیست.
403
ممنوع
اجازه رد/ممنوع (تماس گیرنده شناخته شده و رد شده است). این پاسخ نباید برای ردهایی که ناشی از فرسودگی برخی منابع است استفاده شود (به جای آن از Too Many Requests برای آن خطاها استفاده کنید). در صورتی که تماس گیرنده قابل شناسایی نباشد نباید Forbidden استفاده شود (به جای آن Unauthorized برای آن خطاها استفاده کنید).
404
پیدا نشد
یافت نشد (منبع پیدا نشد، آدرس اینترنتی نامعتبر، از جمله RPC های نامعتبر)
409
تعارض
این عملیات معمولاً به دلیل یک مشکل همزمانی مانند شکست چک ترتیبدهنده یا لغو تراکنش متوقف شد.
429
درخواست های خیلی زیاد
برخی از منابع تمام شده است، شاید سهمیه هر کاربر، یا شاید کل سیستم فایل خالی است.
499
درخواست بسته مشتری
این عملیات معمولاً توسط تماس گیرنده لغو شد.
500
خطای سرور داخلی
خطاهای داخلی این بدان معنی است که برخی از متغیرهای مورد انتظار سیستم اساسی شکسته شده اند. این کد خطا برای خطاهای جدی رزرو شده است.
501
اجرا نشده
عملیات اجرا نشده یا در این سرویس پشتیبانی/فعال نمی شود.
503
سرویس در دسترس نیست
این سرویس در حال حاضر در دسترس نیست. این به احتمال زیاد یک وضعیت گذرا است، که می توان با تلاش مجدد با عقب نشینی آن را اصلاح کرد.
504
مهلت زمانی دروازه
مهلت قبل از تکمیل عملیات به پایان رسید. برای عملیاتی که وضعیت سیستم را تغییر می دهد، حتی اگر عملیات با موفقیت به پایان رسیده باشد، ممکن است این خطا برگردانده شود. به عنوان مثال، یک پاسخ موفقیتآمیز از یک سرور میتوانست آنقدر به تأخیر بیفتد که مهلت آن به پایان برسد.
گاهی اوقات ممکن است چندین کد خطا اعمال شود. سرویسها باید خاصترین کد خطای اعمال شده را برگردانند.
تاریخ آخرین بهروزرسانی 2024-11-26 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2024-11-26 بهوقت ساعت هماهنگ جهانی."],[[["HTTP status codes indicate the outcome of a request, ranging from success (2xx) to various error types."],["Client errors (4xx) signal issues with the request itself, such as invalid credentials (401) or missing resources (404)."],["Server errors (5xx) indicate problems on the server side, including internal errors (500) or service unavailability (503)."],["When multiple error codes apply, the most specific one should be used."],["Business logic failures, despite not being technical errors, should utilize a 2xx status code with further details provided in the response body."]]],["HTTP responses can include various status codes: 2xx signifies success, used even for business logic failures. 400 indicates bad requests, 401 for unauthorized access, and 403 for forbidden actions. 404 means resource not found, 409 a conflict, and 429 too many requests. 499 denotes client-canceled operation, 500 internal errors, 501 unimplemented features, 503 service unavailability, and 504 gateway timeout. The most specific error code should be used when multiple codes apply.\n"]]