From 8568862a192fb53831cd9bb1d546d6d8b1312507 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Mon, 14 Jan 2019 17:30:55 +0400 Subject: [PATCH] :memo: Add docs for response status codes --- .../tutorial/response-status-code/image01.png | Bin 0 -> 74275 bytes .../tutorial/response-status-code/image02.png | Bin 0 -> 21344 bytes docs/src/response_status_code/tutorial001.py | 8 ++ docs/src/response_status_code/tutorial002.py | 9 +++ docs/tutorial/response-status-code.md | 71 ++++++++++++++++++ mkdocs.yml | 1 + 6 files changed, 89 insertions(+) create mode 100644 docs/img/tutorial/response-status-code/image01.png create mode 100644 docs/img/tutorial/response-status-code/image02.png create mode 100644 docs/src/response_status_code/tutorial001.py create mode 100644 docs/src/response_status_code/tutorial002.py create mode 100644 docs/tutorial/response-status-code.md diff --git a/docs/img/tutorial/response-status-code/image01.png b/docs/img/tutorial/response-status-code/image01.png new file mode 100644 index 0000000000000000000000000000000000000000..f82803be521ac5f8c0f4a1ef9875d400ea51359c GIT binary patch literal 74275 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 + + +## About HTTP status codes + +!!! note + If you already know what HTTP status codes are, skip to the next section. + +In HTTP, you send a numeric status code of 3 digits as part of the response. + +These status codes have a name associated to recognize them, but the important part is the number. + +In short: + +* `100` and above are for "Information". You rarely use them directly. +* **`200`** and above are for "Successful" responses. These are the ones you would use the most. + * `200` is the default status code, which means everything was "OK". + * Another example would be `201`, "Created". It is commonly used after creating a new record in the database. +* `300` and above are for "Redirection". +* **`400`** and above are for "Client error" responses. These are the second type you would probably use the most. + * An example is `404`, for a "Not Found" response. + * For generic errors from the client, you can just use `400`. +* `500` and above are for server errors. You almost never use them directly. When something goes wrong at some part in your application code, or server, it will automatically return one of these status codes. + +!!! tip + To know more about each status code and which code is for what, check the MDN documentation about HTTP status codes. + + +## Shortcut to remember the names + +Let's see the previous example again: + +```Python hl_lines="6" +{!./src/response_status_code/tutorial001.py!} +``` + +`201` is the status code for "Created". + +But you don't have to memorize what each of these codes mean. + +You can use the convenience variables from `starlette.status`. + +```Python hl_lines="2 7" +{!./src/response_status_code/tutorial002.py!} +``` + +They are just a convenience, they hold the same number, but that way you can use the editor's autocomplete to find them: + + diff --git a/mkdocs.yml b/mkdocs.yml index 6fe4d9763d..c687756a4e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -33,6 +33,7 @@ nav: - Header Parameters: 'tutorial/header-params.md' - Response Model: 'tutorial/response-model.md' - Extra Models: 'tutorial/extra-models.md' + - Response Status Code: 'tutorial/response-status-code.md' - Form Data: 'tutorial/request-forms.md' - Request Files: 'tutorial/request-files.md' - Request Forms and Files: 'tutorial/request-forms-and-files.md' -- 2.47.3