{"id":35,"date":"2024-11-06T10:00:00","date_gmt":"2024-11-06T16:00:00","guid":{"rendered":"https:\/\/douglasstarnes.dev\/?p=35"},"modified":"2024-11-03T09:02:13","modified_gmt":"2024-11-03T15:02:13","slug":"building-a-rest-api-with-fastapi","status":"publish","type":"post","link":"https:\/\/douglasstarnes.dev\/index.php\/2024\/11\/06\/building-a-rest-api-with-fastapi\/","title":{"rendered":"Building a REST API with FastAPI"},"content":{"rendered":"\n

In the previous post<\/a> we saw how to create a simple FastAPI application, run it with uvicorn and use the interactive documentation. But that application only implemented an endpoint that handled GET requests. In this post, we will see how to implement the other HTTP methods (POST, PUT, DELETE) to complete the API.<\/p>\n\n\n\n

Representing Data in FastAPI<\/h2>\n\n\n\n

One of the advantages of FastAPI is that it takes advantage of modern Python features including type hints. We will see that FastAPI can validate the structure of a JSON payload if we define a type to represent it. FastAPI is built upon the pydantic package that enforces Python type hints at runtime. (by default, the Python interpreter ignores type hints) pydantic provides a base class we can use to define the expected structure of a JSON payload.<\/p>\n\n\n\n

<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
from<\/span> pydantic <\/span>import<\/span> BaseModel<\/span><\/span>\n<\/span>\nclass<\/span> <\/span>TodoItem<\/span>(<\/span>BaseModel<\/span>):<\/span><\/span>\n  <\/span>id<\/span>:<\/span> <\/span>int<\/span><\/span>\n  task<\/span>:<\/span> <\/span>str<\/span><\/span>\n  complete<\/span>:<\/span> <\/span>bool<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
As you might expect, each field in the TodoItem class is annotated with a type hint.  Now we can create a list of TodoItem to masquerade as a database until we integrate a real database in a later post.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
todo_db <\/span>=<\/span> <\/span>[<\/span><\/span>\n  <\/span>TodoItem<\/span>(<\/span>id<\/span>=<\/span>1<\/span>,<\/span> <\/span>task<\/span>=<\/span>"<\/span>Task One<\/span>"<\/span>,<\/span> <\/span>complete<\/span>=True<\/span>),<\/span><\/span>\n  <\/span>TodoItem<\/span>(<\/span>id<\/span>=<\/span>2<\/span>,<\/span> <\/span>task<\/span>=<\/span>"<\/span>Task Two<\/span>"<\/span>,<\/span> <\/span>complete<\/span>=False<\/span>)<\/span><\/span>\n]<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Refactor the Existing Application<\/h2>\n\n\n\n
Before adding new endpoints for the POST, PUT and DELETE methods, we can refactor the existing GET endpoint to use type hints.  First, rename it to get_all_todos <\/code>as this handler function will return the entire “database” of TodoItem<\/code>s.  The get<\/code> decorator has the response_model <\/code>keyword argument that tells which type the handler function will return.  Here it will return a List <\/code>of TodoItem<\/code>.  The List <\/code>type from the typing <\/code>module needs to be imported.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
from<\/span> typing <\/span>import<\/span> List<\/span><\/span>\n<\/span>\n@<\/span>api<\/span>.<\/span>get<\/span>(<\/span>"<\/span>\/<\/span>"<\/span>,<\/span> <\/span>response_model<\/span>=<\/span>List<\/span>[<\/span>TodoItem<\/span>])<\/span><\/span>\ndef<\/span> <\/span>get_all_todos<\/span>():<\/span><\/span>\n  <\/span>return<\/span> todos<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
If you run the application and invoke the root endpoint, it won’t behave any differently.  Notice though that the interactive documentation now includes information about the schema of the response.  And this schema is the TodoItem <\/code>just added.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Also, notice that JSON returned looks the same as it did before.  As mentioned in the previous post, FastAPI will convert between Python types and JSON if possible.  FastAPI knows how to convert BaseModel <\/code>subclasses into JSON so it did that here.<\/p>\n\n\n\n
Retrieving Single TodoItems<\/h2>\n\n\n\n
Here is the route and handler function to get a single TodoItem <\/code>by its unique id.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
from<\/span> fastapi <\/span>import<\/span> HTTPException<\/span><\/span>\n<\/span>\n@<\/span>api<\/span>.<\/span>get<\/span>(<\/span>"<\/span>\/todo\/<\/span>{todo_id}<\/span>"<\/span>,<\/span> <\/span>response_model<\/span>=<\/span>TodoItem<\/span>)<\/span><\/span>\ndef<\/span> <\/span>get_todo_by_id<\/span>(<\/span>todo_id<\/span>:<\/span> <\/span>int<\/span>):<\/span><\/span>\n  <\/span>for<\/span> todo <\/span>in<\/span> todos<\/span>:<\/span><\/span>\n    <\/span>if<\/span> todo<\/span>.<\/span>id <\/span>==<\/span> todo_id<\/span>:<\/span><\/span>\n      <\/span>return<\/span> todo<\/span><\/span>\n  <\/span>raise<\/span> <\/span>HTTPException<\/span>(<\/span>status_code<\/span>=<\/span>404<\/span>,<\/span> <\/span>detail<\/span>=<\/span>"<\/span>TodoItem not found<\/span>"<\/span>)<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
There are several new concepts in this snippet so let’s look at them.<\/p>\n\n\n\n
First, in the get <\/code>decorator on line 3, the path includes a parameter named todo_id<\/code>.  In other words, the value included in the second path segment, after \/todo<\/code>, will be passed to the handler function.  In line 4, the handler function accepts an argument named todo_id<\/code>. And it is annotated with the type hint int<\/code>.  Thus trying to access the path \/todo\/abc<\/code> would raise an error as “abc” cannot be converted to an integer.<\/p>\n\n\n\n
As this application is not (yet) using a real database, the process of looking for a TodoItem <\/code>with an id is done by brute force.  Simply loop through the todos <\/code>list and if a TodoItem <\/code>with the selected id <\/code>is found, return it.  If the end of the loop is reached on line 8, that means the TodoItem <\/code>was not found.  In that case, raise an exception, an HTTPException <\/code>in this case.  The HTTPException <\/code>is imported on line 1 from the fastapi <\/code>module.  The HTTPException <\/code>expects a status_code <\/code>and a detail <\/code>message.  The status_code <\/code>here is 404 as there was no TodoItem <\/code>with the todo_id<\/code>.  The detail <\/code>message will be returned in the JSON payload from the handler function.<\/p>\n\n\n\n
Run the application and go to the \/docs path in the browser.  There is a new item for the \/todo\/{todo_id} path.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Expand it, and click the Try it out<\/strong> button.  Notice that the docs have an input for the todo_id <\/code>path parameter.  Also, under the parameter name, is a reminder that this should be an integer. This was derived from the type hint in the code.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Enter 1 in the input box and click the blue Execute<\/strong> button.  Scroll down to see that the JSON representation of the TodoItem <\/code>with an id of 1 has been returned.<\/p>\n\n\n\n
Now try to get an id of 100.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
There is no TodoItem <\/code>with an id <\/code>of 100.  Therefore, the HTTPException <\/code>is raised resulting in the 404 status code.  Also the detail message from the HTTPException <\/code>is included in the response body.<\/p>\n\n\n\n
What happens if you try to get an id that can’t be converted into an integer?  Put “abc” in the input box and click the Execute<\/strong> button.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
The interactive docs won’t let you do this.  And it’s kind of disappointing because you don’t get to see the actual response if you tried to do this in an application.  The actual response is a 422 status code which means Unprocessable Entity<\/em>.  This makes sense.  As the string “abc” cannot be converted into an integer, the value cannot be processed.<\/p>\n\n\n\n
Adding New TodoItems<\/h2>\n\n\n\n
Adding a new TodoItem <\/code>is done with the POST method. To route a POST request to a function handler, use the post <\/code>decorator. Even though there is no parameter in the path, a todo <\/code>parameter is expected by the new_todo <\/code>function. This is because the TodoItem <\/code>will be constructed from JSON data included in the body of the POST request. In addition to converting BaseModel <\/code>subclasses to JSON like we saw in the GET endpoints, FastAPI can also convert JSON to BaseModel <\/code>subclasses. The todo <\/code>is then appended to the todos <\/code>list. Don’t worry about conflicting ids right now, we’ll take care of that soon.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
@<\/span>api<\/span>.<\/span>post<\/span>(<\/span>"<\/span>\/todo<\/span>"<\/span>,<\/span> <\/span>response_model<\/span>=<\/span>TodoItem<\/span>)<\/span><\/span>\ndef<\/span> <\/span>new_todo<\/span>(<\/span>todo<\/span>:<\/span> TodoItem<\/span>):<\/span><\/span>\n  todos<\/span>.<\/span>append<\/span>(<\/span>todo<\/span>)<\/span><\/span>\n  <\/span>return<\/span> todo<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Run the application, expand the item for the \/todo<\/code> POST request, and click the Try it out<\/strong> button.  A textarea contains a scaffolded JSON object with keys for the fields in the TodoItem <\/code>class.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Add values for a new TodoItem<\/code>.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
{<\/span><\/span>\n  <\/span>"<\/span>id<\/span>"<\/span>:<\/span> <\/span>100<\/span>,<\/span><\/span>\n  <\/span>"<\/span>task<\/span>"<\/span>:<\/span> <\/span>"<\/span>Task One Hundred<\/span>"<\/span>,<\/span><\/span>\n  <\/span>"<\/span>complete<\/span>"<\/span>:<\/span> <\/span>False<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Press the Execute<\/strong> button. Scroll down and see the results.  The endpoint returned the new TodoItem<\/code>.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Go back to the item for the \/<\/code> path.  Expand the item, click the Try it now<\/strong> button, and the Execute<\/strong> button.  The returned JSON now includes item 100.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Creating a DTO<\/h2>\n\n\n\n
In the current implementation, you could add a TodoItem <\/code>to the “database” with the same id <\/code>as an existing item and the application would allow it.  In addition, you have to explicitly set the complete <\/code>field to True <\/code>despite it making little sense to add a task to a todo list that it already completed.  In other words, when creating a new TodoItem <\/code>you only need to provide the task<\/code>.  The id <\/code>should be automatically generated and the complete <\/code>field should be set to False<\/code>.<\/p>\n\n\n\n
To do this, we can create another subclass of BaseModel <\/code>that contains only the task<\/code>.  This is commonly referred to as a Data Transfer Object<\/em> or DTO<\/em>.  Create a new BaseModel <\/code>subclass and call it CreateTodoItem<\/code>.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
class<\/span> <\/span>CreateTodoItem<\/span>(<\/span>BaseModel<\/span>):<\/span><\/span>\n  task<\/span>:<\/span> <\/span>str<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
In the new_todo <\/code>function, change the type of the todo <\/code>parameter to CreateTodoItem<\/code>.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
def<\/span> <\/span>new_todo<\/span>(<\/span>todo<\/span>:<\/span> CreateTodoItem<\/span>):<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
To make this work, you need to refactor how the todo list is implemented.  Right now it’s a List <\/code>of TodoItem<\/code>.  But it’s going to work better as a dictionary where the keys are the numeric id<\/code>s and the values are TodoItem<\/code>s.  First change the todos <\/code>variable to a dictionary.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
todos <\/span>=<\/span> <\/span>{<\/span><\/span>\n  <\/span>1<\/span>:<\/span> <\/span>TodoItem<\/span>(<\/span>id<\/span>=<\/span>1<\/span>,<\/span> <\/span>task<\/span>=<\/span>"<\/span>Task One<\/span>"<\/span>,<\/span> <\/span>complete<\/span>=True<\/span>),<\/span><\/span>\n  <\/span>2<\/span>:<\/span> <\/span>TodoItem<\/span>(<\/span>id<\/span>=<\/span>2<\/span>,<\/span> <\/span>task<\/span>=<\/span>"<\/span>Task Two<\/span>"<\/span>,<\/span> <\/span>complete<\/span>=False<\/span>),<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
In the get_all_todos <\/code>function you need to return just the values of the dictionary.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
def<\/span> <\/span>get_all_todos<\/span>():<\/span><\/span>\n  <\/span>return<\/span> todos<\/span>.<\/span>values<\/span>()<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
The implementation of get_todo_by_id <\/code>is simplified.  Attempt to get the todo_id <\/code>key from the dictionary and return it on line 3.  If the key doesn’t exist, except<\/code> the KeyError <\/code>and raise the HTTPException<\/code> on line 5.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
def<\/span> <\/span>get_todo_by_id<\/span>(<\/span>todo_id<\/span>:<\/span> <\/span>int<\/span>):<\/span><\/span>\n  <\/span>try<\/span>:<\/span><\/span>\n    <\/span>return<\/span> todos<\/span>[<\/span>todo_id<\/span>]<\/span><\/span>\n  <\/span>except<\/span> <\/span>KeyError<\/span>:<\/span><\/span>\n    <\/span>raise<\/span> <\/span>HTTPException<\/span>(<\/span>status_code<\/span>=<\/span>404<\/span>,<\/span> <\/span>detail<\/span>=<\/span>"<\/span>TodoItem not found<\/span>"<\/span>)<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
And in the new_todo <\/code>function, get the maximum value from the keys on line 2.  Add one to it for the id of the new TodoItem<\/code>.  Then use the id <\/code>and the task <\/code>from the CreateItemTodo <\/code>DTO to create a new TodoItem<\/code> on line 3.  Set the complete keyword argument to False.  Add the new TodoItem to the dictionary using the id as the key on line 4.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
def<\/span> <\/span>new_todo<\/span>(<\/span>todo<\/span>:<\/span> CreateTodoItem<\/span>):<\/span><\/span>\n  next_id <\/span>=<\/span> <\/span>max<\/span>(<\/span>todos<\/span>.<\/span>keys<\/span>())<\/span> <\/span>+<\/span> <\/span>1<\/span><\/span>\n  new_todo <\/span>=<\/span> <\/span>TodoItem<\/span>(<\/span>id<\/span>=<\/span>next_id<\/span>,<\/span> <\/span>task<\/span>=<\/span>todo<\/span>.<\/span>task<\/span>,<\/span> <\/span>complete<\/span>=False<\/span>)<\/span><\/span>\n  todos<\/span>[<\/span>next_id<\/span>]<\/span> <\/span>=<\/span> new_todo<\/span><\/span>\n  <\/span>return<\/span> new_todo<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
You’ll see how much time this saves us when implementing updates with the PUT method.  But first, let’s create another new TodoItem<\/code>.  Run the application, and expand the item in the interactive docs for the POST request.  Notice that the scaffolded JSON only has a key for the task.  Fill it in and click the Execute<\/strong> button.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Take a look at the response body.  As there are already two TodoItem<\/code>s in the dictionary with ids 1 and 2, the new TodoItem <\/code>was given an id of 3.  Also, the complete <\/code>key was set to false <\/code>by default.<\/p>\n\n\n\n
Updating TodoItems<\/h2>\n\n\n\n
To update a TodoItem <\/code>is done using a PUT request.  As you might have guessed there is a put <\/code>decorator to route the URL to the handler function.  But the PUT request is going to be a little different.  First, we have to get an existing TodoItem <\/code>to update.  Refactoring the todo list to be a dictionary has made that simple.  Next we only want to update the fields that have new values.  We do this by creating a new UpdateTodoItem <\/code>DTO and make all of the fields optional.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
from<\/span> typing <\/span>import<\/span> Optional<\/span><\/span>\n<\/span>\nclass<\/span> <\/span>UpdateTodoItem<\/span>(<\/span>BaseModel<\/span>):<\/span><\/span>\n  task<\/span>:<\/span> Optional<\/span>[<\/span>str<\/span>]<\/span> <\/span>=<\/span> <\/span>None<\/span><\/span>\n  complete<\/span>:<\/span> Optional<\/span>[<\/span>bool<\/span>]<\/span> <\/span>=<\/span> <\/span>None<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
In this class, both task <\/code>and complete <\/code>are Optional <\/code>with a default value of None<\/code>.  Thus we need to check for the presence of None <\/code>in each field.  If the field is None<\/code>, do nothing.  Otherwise use the value in the DTO to update the existing TodoItem<\/code>.  Here’s the handler function implementation.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
@<\/span>api<\/span>.<\/span>put<\/span>(<\/span>"<\/span>\/todo\/<\/span>{todo_id}<\/span>"<\/span>,<\/span> <\/span>response_model<\/span>=<\/span>TodoItem<\/span>)<\/span><\/span>\ndef<\/span> <\/span>update_todo<\/span>(<\/span>todo_id<\/span>:<\/span> <\/span>int<\/span>,<\/span> <\/span>todo<\/span>:<\/span> UpdateTodoItem<\/span>):<\/span><\/span>\n  <\/span>try<\/span>:<\/span><\/span>\n    updated_todo <\/span>=<\/span> todos<\/span>[<\/span>todo_id<\/span>]<\/span><\/span>\n    <\/span>if<\/span> todo<\/span>.<\/span>task <\/span>is<\/span> <\/span>not<\/span> <\/span>None<\/span>:<\/span><\/span>\n      updated_todo<\/span>.<\/span>task <\/span>=<\/span> todo<\/span>.<\/span>task<\/span><\/span>\n    <\/span>if<\/span> todo<\/span>.<\/span>complete <\/span>is<\/span> <\/span>not<\/span> <\/span>None<\/span>:<\/span><\/span>\n      updated_todo<\/span>.<\/span>complete <\/span>=<\/span> todo<\/span>.<\/span>complete<\/span><\/span>\n    <\/span>return<\/span> updated_todo<\/span><\/span>\n  <\/span>except<\/span> <\/span>KeyError<\/span>:<\/span><\/span>\n    <\/span>raise<\/span> <\/span>HTTPException<\/span>(<\/span>status_code<\/span>=<\/span>404<\/span>,<\/span> <\/span>detail<\/span>=<\/span>"<\/span>TodoItem not found<\/span>"<\/span>)<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Also, notice the put <\/code>decorator.  It has a path parameter for the todo_id <\/code>which is reflected by the todo_id <\/code>parameter in the update_todo <\/code>function.  But the PUT request also has a JSON body with the update data.  So it has to passed to the update_todo <\/code>function as well.<\/p>\n\n\n\n
Start the application and browse to the interactive documentation.  Expand the PUT endpoint for \/todos\/{todo_id}<\/code> and click the Try it out <\/strong>button.  Notice the is an input box for the todo_id <\/code>path parameter as well as a textarea with a scaffolded JSON object for the UpdateTodoItem <\/code>DTO.  Even though in the UpdateTodoItem, the code marks both fields as optional, the interactive documentation still provides default values for both.  Let’s try it out.<\/p>\n\n\n\n
You still have to provide a valid todo_id <\/code>so put 2 in the input box.  Then delete both fields from the JSON leaving an empty object.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Click the Execute<\/strong> button and scroll down to the response body.  The response body contains the JSON for the updated TodoItem<\/code>.  But the values for task <\/code>and complete <\/code>have not changed.  That’s because they were omitted from the request body JSON.  <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Go back to the request body and add a key for complete <\/code>and set it to true<\/code>.  <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Click the Execute<\/strong> button and notice in the response body now contains an updated value for complete<\/code>.  But the value of task<\/code>, which was omitted from the request JSON, has not changed.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Go to the endpoint for \/<\/code> and execute it to get all of the TodoItem<\/code>s and notice that the updated value of complete <\/code>for item 2 has been persisted in the application.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Deleting TodoItems<\/h2>\n\n\n\n
To delete a TodoItem<\/code>, apply the delete <\/code>decorator to a handler function.  The path will require a parameter todo_id<\/code>.  The handler function will attempt to delete that key from the dictionary.  If the key does not exist, the it will raise a KeyError<\/code>.  The application will then raise an HTTPException <\/code>with a 404 status code.  <\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
@<\/span>api<\/span>.<\/span>delete<\/span>(<\/span>"<\/span>\/todo\/<\/span>{todo_id}<\/span>"<\/span>,<\/span> <\/span>status_code<\/span>=<\/span>204<\/span>)<\/span><\/span>\ndef<\/span> <\/span>delete_todo<\/span>(<\/span>todo_id<\/span>:<\/span> <\/span>int<\/span>):<\/span><\/span>\n  <\/span>try<\/span>:<\/span><\/span>\n    <\/span>del<\/span> todos<\/span>[<\/span>todo_id<\/span>]<\/span><\/span>\n    <\/span>return<\/span><\/span>\n  <\/span>except<\/span> <\/span>KeyError<\/span>:<\/span><\/span>\n    <\/span>raise<\/span> <\/span>HTTPException<\/span>(<\/span>status_code<\/span>=<\/span>404<\/span>,<\/span> <\/span>detail<\/span>=<\/span>"<\/span>TodoItem not found<\/span>"<\/span>)<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Notice the use of the status_code <\/code>keyword argument in the delete <\/code>decorator.  A successful DELETE request should not return a response body but it should have a 204 status code.  And the handler function does not return a value.<\/p>\n\n\n\n
In the interactive documentation, deleting item number one returns no response body and a 204 status code.  <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
And the list of TodoItem<\/code>s contains only the second one.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Summary<\/h2>\n\n\n\n
In this post, you saw how to use FastAPI to complete a REST API.  You implemented the POST, PUT and DELETE methods.  You saw how to use the BaseModel class to structure the body of requests and responses.  And you used the interactive documentation to try things out.  Of course you could still use Postman to test the API or use requests to call it in code.<\/p>\n","protected":false},"excerpt":{"rendered":"
In the previous post we saw how to create a simple FastAPI application, run it…<\/p>\n","protected":false},"author":1,"featured_media":70,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[3,4],"class_list":["post-35","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-fastapi","tag-fastapi","tag-python"],"_links":{"self":[{"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/posts\/35","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/comments?post=35"}],"version-history":[{"count":14,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/posts\/35\/revisions"}],"predecessor-version":[{"id":69,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/posts\/35\/revisions\/69"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/media\/70"}],"wp:attachment":[{"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/media?parent=35"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/categories?post=35"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/douglasstarnes.dev\/index.php\/wp-json\/wp\/v2\/tags?post=35"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}