Referencia de códigos HTTP

100 Continue

The server accepted the request headers.

Example: Expect: 100-continue before sending a large body.

101 Switching Protocols

The client asked to switch protocols.

Example: Upgrade: websocket

200 OK

The request succeeded.

Example: GET /users/42 → user JSON

201 Created

A resource was created.

Example: POST /orders → 201 with Location

202 Accepted

Accepted for async processing.

Example: POST /jobs → 202 + job id

204 No Content

Success with an empty body.

Example: DELETE /items/9

206 Partial Content

A range request succeeded.

Example: Range: bytes=0-1023

301 Moved Permanently

The resource has a new permanent URL.

Example: HTTP to HTTPS redirect

302 Found

Temporary redirect. Method may change.

Example: Login bounce

304 Not Modified

Cached representation is still valid.

Example: If-None-Match hit

307 Temporary Redirect

Temporary redirect that keeps the method.

Example: POST stays POST

308 Permanent Redirect

Permanent redirect that keeps the method.

Example: API version move

400 Bad Request

The request is malformed.

Example: Invalid JSON body

401 Unauthorized

Authentication is required or failed.

Example: Missing Bearer token

403 Forbidden

Authenticated but not allowed.

Example: Role cannot delete

404 Not Found

No matching resource.

Example: GET /users/missing

405 Method Not Allowed

HTTP method is not supported.

Example: PUT on a GET-only route

409 Conflict

The request conflicts with current state.

Example: Duplicate email

410 Gone

The resource is gone permanently.

Example: Retired API path

415 Unsupported Media Type

Content-Type is not accepted.

Example: Posted XML to a JSON API

422 Unprocessable Entity

Syntax is valid but semantics failed.

Example: Schema validation error

429 Too Many Requests

Rate limit exceeded.

Example: Retry-After: 30

500 Internal Server Error

Unexpected server failure.

Example: Unhandled exception

502 Bad Gateway

An upstream proxy got an invalid response.

Example: API gateway to dead service

503 Service Unavailable

Temporarily overloaded or down.

Example: Maintenance window

504 Gateway Timeout

An upstream proxy timed out.

Example: Slow dependency