Skip to content

Instantly share code, notes, and snippets.

@subfuzion

subfuzion/http-status-codes.md

Last active September 3, 2023 09:15
Show Gist options
  • Star 80 You must be signed in to star a gist
  • Fork 31 You must be signed in to fork a gist
  • Save subfuzion/669dfae1d1a27de83e69 to your computer and use it in GitHub Desktop.
Save subfuzion/669dfae1d1a27de83e69 to your computer and use it in GitHub Desktop.
Download ZIP
General REST API HTTP Status Codes
Raw
http-status-codes.md

Reference: RFC 2616 - HTTP Status Code Definitions

General

  • 400 BAD REQUEST: The request was invalid or cannot be otherwise served. An accompanying error message will explain further. For security reasons, requests without authentication are considered invalid and will yield this response.
  • 401 UNAUTHORIZED: The authentication credentials are missing, or if supplied are not valid or not sufficient to access the resource.
  • 403 FORBIDDEN: The request has been refused. See the accompanying message for the specific reason (most likely for exceeding rate limit).
  • 404 NOT FOUND: The URI requested is invalid or the resource requested does not exists.
  • 406 NOT ACCEPTABLE: The request specified an invalid format.
  • 410 GONE: This resource is gone. Used to indicate that an API endpoint has been turned off.
  • 429 TOO MANY REQUESTS: Returned when a request cannot be served due to the application’s rate limit having been exhausted for the resource.
  • 500 INTERNAL SERVER ERROR: Something is horribly wrong.
  • 502 BAD GATEWAY: The service is down or being upgraded. Try again later.
  • 503 SERVICE UNAVAILABLE: The service is up, but overloaded with requests. Try again later.
  • 504 GATEWAY TIMEOUT: Servers are up, but the request couldn’t be serviced due to some failure within our stack. Try again later.

HTTP GET

  • 200 OK: The request was successful and the response body contains the representation requested.
  • 302 FOUND: A common redirect response; you can GET the representation at the URI in the Location response header.
  • 304 NOT MODIFIED: There is no new data to return.

HTTP POST or PUT

  • 201 OK: The request was successful, we updated the resource and the response body contains the representation.
  • 202 ACCEPTED: The request has been accepted for further processing, which will be completed sometime later.

HTTP DELETE

  • 202 ACCEPTED: The request has been accepted for further processing, which will be completed sometime later.
  • 204 OK: The request was successful; the resource was deleted.
@olibre
Copy link

olibre commented Oct 25, 2019 •
edited

Thanks, I have just wrote a longer version: http://olibre.github.io/GreatTips/web/api.html

@Yousha
Copy link

Yousha commented Feb 2, 2020

Primarily opinion-based

https://restfulapi.net/http-status-codes/

@QasimWani
Copy link

What is 409 error? It reflects a conflict when using a PUT request but no mention here. How do we handle it?

hey, did u figure out what 409 error represents? Documentation says conflict, but there's no description of it.

@jbrasileiro
Copy link

404 NOT FOUND is about URI, not about the state of the object in server.

@anonymousdomain
Copy link

i have generated personal access token 24hr ago and now its responding with 401 status code
how can i generate access token that can last for week

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment