ورقة مرجعية لرموز حالة HTTP

حتى لا تضطرّ إلى الرجوع إلى المواصفة في كل مرّة، جمعنا حسب الفئة رموز الحالة التي تُصادفها أكثر من غيرها عمليًا. وبالضغط على كل رمز في القائمة أدناه تنتقل إلى صفحة تفصيلية تتضمّن معناه، ومتى يحدث، وأسبابه، وطرق حلّه.

معايير سريعة للحكم: الرموز 2xx تعني النجاح، و3xx تعني النقل (إعادة التوجيه)، و4xx تعني مشكلة في الطلب (العميل)، و5xx تعني مشكلة في الخادم. فإذا رأيت رمز 4xx فتحقّق أولًا من عنوان الطلب URL والترويسات والمصادقة؛ وإذا رأيت رمز 5xx فتحقّق أولًا من سجلّات الخادم وحالة الواجهة الخلفية.

رموز الحالة الشائعة في لمحة

2xxنجاح (Success)

200OK شائعThe request succeeded. The response body depends on the method used.201Created شائعThe request succeeded and a new resource was created as a result.204No Content شائعThe request succeeded but there is no content to return.

3xxإعادة توجيه (Redirection)

301Moved Permanently شائعThe resource has permanently moved to a new URL given in the Location header.302Found شائعThe resource temporarily resides at a different URL; keep using the original URL.304Not Modified شائعThe cached copy is still valid, so no body is sent.

4xxخطأ من العميل (Client Error)

400Bad Request شائعThe server cannot process the request due to a client error such as malformed syntax.401Unauthorized شائعAuthentication is required and has failed or not been provided (i.e. unauthenticated).403Forbidden شائعThe server understood the request but refuses to authorize it. Re-authenticating will not help.404Not Found شائعThe server cannot find the requested resource. The most well-known status code.405Method Not Allowed شائعThe HTTP method is known but not supported for the target resource.409Conflict شائعThe request conflicts with the current state of the resource.422Unprocessable Content شائعThe request is well-formed but has semantic errors (e.g. validation failed).429Too Many Requests شائعThe client has sent too many requests in a given time (rate limiting).

5xxخطأ من الخادم (Server Error)

500Internal Server Error شائعA generic catch-all: the server hit an unexpected condition and could not complete the request.502Bad Gateway شائعA gateway or proxy received an invalid response from an upstream server.503Service Unavailable شائعThe server is temporarily unable to handle the request due to overload or maintenance.504Gateway Timeout شائعA gateway or proxy did not get a timely response from an upstream server.