HTTP POST Request Method

 HTTP POST Request Method

  • Used to create data
  • POST can have a body that has additional information that GET does not have
  • Example of Body:
    • {"title": "Title Seven", "author": "Author Two", "category": "math"}

POST request need body as additional information to create data by using API.
So we need to import Body from Fastapi package.

from fastapi import Body, FastAPI

As get cannot have body but post will have body which is the information it need to create by using API endpoint in a database or in any variable for usage.

Note: Do remember at the time of passing body to api-end point for post request give strings in double quotation not in single quotation. As body need to be of json format.

If you will give body as input parameter to GET method it will compile but will give error at the time of API run as body is not permitted for GET request.

Code and Result:

# This code is to create the api endpoint for providing list of books as result to
user whenever a link is clicked.
from fastapi import Body, FastAPI

app = FastAPI() # allow uvicorn to identify the application is created by using
FastAPI and it is the entry point for the application.
# This is the first API endpoint that will be created to return a simple message.


BOOKS = [
    {'title': 'Title one', 'author': 'Author one', 'category': 'science'},
    {'title': 'Title two', 'author': 'Author two', 'category': 'science'},
    {'title': 'Title three', 'author': 'Author three', 'category': 'history'},
    {'title': 'Title four', 'author': 'Author four', 'category': 'math'},
    {'title': 'Title five', 'author': 'Author five', 'category': 'math'}
]
@app.get("/api-endpoint") # It is a decorator that tells FastAPI that this function
is an API endpoint and will call the function below when a GET request is made
to the specified path.
async def first_api():
    return {"message": "Hello Puneet!"}

@app.get("/books") # Static path parameter is used here.
async def read_all_books():
    """
    This function returns the list of books.
    """
    return BOOKS

@app.get("/books/mybooks") # Static path parameter is used here.
async def read_all_books():
    """
    This function returns the list of books.
    """
    return {'book_title': 'My Favorite Book!'}

@app.get("/books/{book_title}") # Dynamic path parameter is used here.
async def read_book(book_title: str):
    """
    This function returns the book details based on the book title.
    """
    for book in BOOKS:
        if book.get('title').casefold() == book_title.casefold():
            # casefold() is used to make the comparison case-insensitive
            return book


"""
@app.get("/books/{dynamic_param}") # General one to just show what is passed in
dynamic path parameter.
async def read_all_books(dynamic_param: str):
"""
"""
    This function returns the list of books based on the dynamic parameter.
"""
"""
    return {"dynamic_param": dynamic_param}
"""


@app.get("/book/") # Here fastapi will understand that this path is not using dynamic
parameter but using query parameter.
async def read_category_by_query(category: str):
    """
    This function returns the list of books based on the category.
    """
    book_to_return = []
    for book in BOOKS:
        if book.get('category').casefold() == category.casefold():
            book_to_return.append(book)
    return book_to_return

@app.get("/book/{book_author}/")
async def read_books_by_author_category_query(book_author: str, category: str = None):
    """
    This function returns the list of books based on the author.
    """
    book_to_return = []
    for book in BOOKS:
        if (book.get('author').casefold() == book_author.casefold()) and (category is
None or book.get('category').casefold() == category.casefold()):
            book_to_return.append(book)
    return book_to_return


@app.post("/books/create_book") # This is a POST request to create a new book.
async def create_book(new_book=Body()):
    """
    This function creates a new book and adds it to the list of books.
    """
    BOOKS.append(new_book)
    return {"message": "Book created successfully!", "book": new_book, "total_books":
len(BOOKS), "all_books": BOOKS}




Comments

Post a Comment

Popular posts from this blog

Post Request with Pydantic usage (input validator)

Image
Post Request by using Pydantic Pydantic Python library that is used for data modeling, data parsing and has efficient error handling. Pydantics is commonly used as a resource for data validation and how to handle data coming to our FastAPI application. Pydantic implementation mechanism Create a different request model for data validation Field data validation on each variable/element BaseModel is the Pydantics BaseModel class which will provide facility to validate data. Field is the keyword to do it. As it will help to provide constraints for data validation. sample class BookRequest(BaseModel):     id: int = Field(gt=0)     title: str = Field(min_length=3)     author: str = Field(min_length=1)     description: str = Field(min_length=1, max_length=100)     rating: int = Field(gt=0, lt=5) Book Request and Book Conversion We will convert the Pydantic Request into a Book Example for post request method @app.post("/create_book") async def c...
Read more

Code Scalability and Routing

Image
 Creating Authentication file As we need to keep authentication part separate from our main application working so that we will not mess-up with our main application logic and it's security settings and authentication criteria as well as logics. auth.py - Basic authentication code stub. # This file is to define authenticator and authorization for the Todo application. from fastapi import FastAPI , status app = FastAPI () @ app . get ( "/auth" , status_code = status . HTTP_200_OK ) async def get_user ():     return { 'user' : 'authenticated_user' } Create Routers Package Here we want to use both and auth.py and main.py file to run together and to allow routers to run smoothly and want to scale the project code. To make this possible we need to use router facility or FastAPI. Here we are going to have a main file is a route of our application and routes will sit on this main file and will help in performing the tasks on call from main file. To make i...
Read more

CRUD Assignment

Image
 CRUD Assignment 1. Create a new API Endpoint that can fetch all books from a specific author using either Path Parameters or Query Parameters. Code and Result: As async is implemented by FastAPI itself hence ignored it. from fastapi import FastAPI app = FastAPI () BOOKS = [         { "title" : "Book One" , "author" : "Author A" , "category" : "Fiction" },         { "title" : "Book Two" , "author" : "Author B" , "category" : "Non-Fiction" },         { "title" : "Book Three" , "author" : "Author A" , "category" : "Biography" },         { "title" : "Book Four" , "author" : "Author A" , "category" : "Historical" },         { "title" : "Book Five" , "author" : "Author A" , "category" : "Romanc...
Read more