이름 또는 코드로 검색하여 모든 HTTP 상태 코드를 찾으세요. 설명, 예시, 모범 사례 포함.
60 상태 코드
The server has received the request headers and the client should proceed to send the request body.
사용 사례: Large file uploads — client sends Expect: 100-continue before body.
The server agrees to switch protocols as requested by the client.
사용 사례: WebSocket upgrades: HTTP → WebSocket.
The server has received and is processing the request, but no response is yet available.
사용 사례: Long-running WebDAV operations to prevent client timeout.
Returns response headers before the final response, allowing the client to preload resources.
사용 사례: Preloading critical CSS/JS while the server prepares the full response.
The request has succeeded. The response body contains the requested resource.
사용 사례: Standard successful GET, POST, PUT, PATCH responses.
The request has been fulfilled and a new resource has been created.
사용 사례: Successful POST that creates a resource. Include Location header pointing to new resource.
The request has been accepted for processing but processing has not been completed.
사용 사례: Async operations: email sending, report generation, batch jobs.
The response is successful but the information was obtained from a third-party source.
사용 사례: Proxies or mirrors that transform the original response.
The server successfully processed the request but returns no content.
사용 사례: DELETE operations, form submissions with no redirect, successful PATCH with no body needed.
The server successfully processed the request and asks the client to reset the document view.
사용 사례: Forms — server wants the client to clear the form after submission.
The server is delivering only part of the resource due to a range header sent by the client.
사용 사례: Video streaming, resumable file downloads, pagination of large binary resources.
The response body contains status information for multiple independent operations.
사용 사례: WebDAV batch operations where each sub-request has its own status.
Members of a DAV binding have already been enumerated in a previous reply.
사용 사례: WebDAV — avoids re-listing resources already returned.
The server has fulfilled a GET for the resource and the response represents the result of one or more instance manipulations.
사용 사례: HTTP delta encoding — differential responses for caching efficiency.
The request has more than one possible response. The user should choose one.
사용 사례: Content negotiation — multiple formats or languages available.
The resource has been permanently moved to a new URL. Future requests should use the new URL.
사용 사례: Site migration, domain changes. Passes full SEO link equity to new URL.
The resource is temporarily at a different URL. Client should continue using original URL.
사용 사례: Temporary maintenance pages, A/B testing redirects.
The server directs the client to get the requested resource at another URI using a GET request.
사용 사례: Post/Redirect/Get pattern — after a successful POST, redirect to a confirmation page.
The resource has not been modified since the last request. Client should use its cached version.
사용 사례: Conditional GET with If-None-Match or If-Modified-Since. Saves bandwidth.
The resource is temporarily at a different URL. The method and body must not change.
사용 사례: Like 302, but guarantees the HTTP method is preserved on redirect.
The resource has permanently moved. The method and body must not change.
사용 사례: Like 301 but method-preserving. Good for migrating POST endpoints.
The server cannot process the request due to client error (malformed syntax, invalid parameters).
사용 사례: Invalid JSON body, missing required fields, invalid query params, validation failures.
The client must authenticate itself to get the requested response.
사용 사례: Missing or invalid Bearer token / API key. Should trigger a login prompt.
Reserved for future use; some APIs use it for subscription/paywall responses.
사용 사례: Paywalled API endpoints, exceeded free-tier limits, subscription required.
The client is authenticated but lacks permission to access the resource.
사용 사례: User is logged in but lacks the required role or ownership. Don't reveal resource existence.
The server cannot find the requested resource. The URL may be incorrect or the resource deleted.
사용 사례: Missing pages, deleted resources, invalid IDs. Most common HTTP error.
The HTTP method is not supported for the requested resource.
사용 사례: Calling DELETE on a read-only endpoint. Include Allow header listing valid methods.
The server cannot produce a response matching the Accept headers sent by the client.
사용 사례: Client requests application/xml but only JSON is available.
The client must authenticate itself with the proxy server.
사용 사례: Corporate proxy requiring credentials before passing requests through.
The server timed out waiting for the request.
사용 사례: Client took too long to send the complete request. Server closes the connection.
The request conflicts with the current state of the server.
사용 사례: Duplicate username registration, version conflicts in optimistic concurrency.
The resource is permanently deleted and will not be available again.
사용 사례: Deleted content where you want search engines to deindex permanently.
The server requires a Content-Length header in the request.
사용 사례: API endpoints that need to pre-allocate resources based on expected body size.
The server does not meet a precondition the client specified in its headers.
사용 사례: Optimistic concurrency with If-Match/ETags. Edit conflict detection.
The request body is larger than the server is willing to process.
사용 사례: File upload exceeds limit. Include Retry-After if temporary.
The URI provided was too long for the server to process.
사용 사례: Excessively long query strings, typically from GET requests with too much data.
The media format of the request body is not supported by the server.
사용 사례: Sending XML to an endpoint that only accepts JSON.
The range specified in the Range header cannot be fulfilled.
사용 사례: File download resumed beyond the file's actual size.
The expectation indicated in the Expect header cannot be met by the server.
사용 사례: Client sends Expect: 100-continue but server can't accommodate it.
The server refuses to brew coffee because it's a teapot (RFC 2324 April Fools' joke).
사용 사례: Easter egg in APIs. Some services use it to reject clearly bot-driven requests.
The request was well-formed but failed semantic validation.
사용 사례: JSON is valid but business logic validation fails (e.g., end date before start date).
The resource that is being accessed is locked.
사용 사례: WebDAV — file checked out by another user.
The request failed because it depended on another request that failed.
사용 사례: WebDAV batch operations where a prior step failed.
The server is unwilling to process a request that might be replayed.
사용 사례: TLS 0-RTT early data that could be a replay attack.
The client should switch to a different protocol.
사용 사례: Server requires HTTPS but received HTTP, or requires HTTP/2.
The server requires the request to be conditional to prevent lost updates.
사용 사례: API requires If-Match header for update operations to prevent conflicts.
The user has sent too many requests in a given amount of time (rate limiting).
사용 사례: API rate limits exceeded. Include Retry-After header with wait time.
The server is unwilling to process the request because its header fields are too large.
사용 사례: Excessively large cookies or too many custom headers.
The resource is unavailable due to legal reasons such as government censorship.
사용 사례: GDPR compliance blocking, DMCA takedowns, regional legal restrictions.
The server encountered an unexpected condition that prevented it from fulfilling the request.
사용 사례: Unhandled exceptions, database errors, configuration issues. Generic catch-all.
The server does not support the functionality required to fulfill the request.
사용 사례: HTTP method not recognized or not yet implemented by the server.
The server, while acting as a gateway, received an invalid response from the upstream server.
사용 사례: Upstream API timeout, crashed microservice behind load balancer.
The server is temporarily unable to handle the request due to overload or maintenance.
사용 사례: Planned maintenance, server overload. Include Retry-After header.
The server, acting as a gateway, did not receive a timely response from the upstream server.
사용 사례: Slow database queries, slow microservices causing proxy timeouts.
The HTTP protocol version used in the request is not supported by the server.
사용 사례: Rare — client uses an unsupported HTTP version.
The server has an internal configuration error with transparent content negotiation.
사용 사례: Circular reference in content negotiation configuration.
The server is unable to store the representation needed to complete the request.
사용 사례: WebDAV — disk full. Also used in some APIs for quota exhaustion.
The server detected an infinite loop while processing the request.
사용 사례: WebDAV — infinite loop in directory binding.
Further extensions to the request are required for the server to fulfill it.
사용 사례: HTTP Extension Framework — specific extension policy not met.
The client needs to authenticate to gain network access.
사용 사례: Captive portals — hotel/airport Wi-Fi login pages.
HTTP 상태 코드는 클라이언트 요청에 대한 응답으로 웹 서버가 반환하는 3자리 숫자입니다. 요청이 성공, 리다이렉션 또는 오류가 발생했는지 나타냅니다. 첫 번째 자리는 응답 클래스를 정의합니다: 1xx(정보), 2xx(성공), 3xx(리다이렉션), 4xx(클라이언트 오류), 5xx(서버 오류).
301(영구 이동)은 브라우저와 검색 엔진에게 페이지가 새 URL로 영구적으로 이동했음을 알리고, 새 URL에 전체 SEO 링크 에쿼티를 전달합니다. 302(발견 / 임시 리다이렉션)는 임시 이동을 신호하며, 브라우저는 리다이렉션하지만 검색 엔진은 일반적으로 원래 URL을 인덱스에 유지합니다.
401 Unauthorized는 클라이언트가 인증되지 않았음을 의미합니다 — 자격 증명이 제공되지 않았거나 유효하지 않습니다. 403 Forbidden은 클라이언트가 인증되었지만 리소스에 액세스할 권한이 없음을 의미합니다. 로그인을 유도하려면 401을, 사용자가 로그인했지만 권한이 없을 때는 403을 사용하세요.
리소스를 생성하는 성공적인 POST의 경우, 새 리소스를 가리키는 Location 헤더와 함께 201 Created를 반환합니다. 리소스를 생성하지 않고 처리를 트리거하는 성공적인 POST의 경우, 200 OK를 반환합니다. 처리가 완료되지 않은 비동기 작업의 경우, 202 Accepted를 반환합니다.