HTTPException usage in FastAPI - Step-by-Step Execution

Concept Flow - HTTPException usage

Request received

↓

Check condition

↓

Raise HTTPException

↓

Client receives response

When a request comes in, the code checks a condition. If the condition is true, it raises an HTTPException to send an error response. Otherwise, it returns a normal response.

Execution Sample

FastAPI

from fastapi import FastAPI, HTTPException
app = FastAPI()

@app.get('/items/{item_id}')
async def read_item(item_id: int):
    if item_id < 1:
        raise HTTPException(status_code=400, detail='Invalid ID')
    return {'item_id': item_id}

This code checks if the item_id is less than 1. If yes, it raises an HTTPException with status 400. Otherwise, it returns the item_id.

Execution Table

Step	Input item_id	Condition (item_id < 1)	Action	Output/Response
1	0	True	Raise HTTPException(400, 'Invalid ID')	HTTP 400 Bad Request with detail 'Invalid ID'
2	1	False	Return {'item_id': 1}	{'item_id': 1}
3	5	False	Return {'item_id': 5}	{'item_id': 5}
4	-3	True	Raise HTTPException(400, 'Invalid ID')	HTTP 400 Bad Request with detail 'Invalid ID'

💡 Execution stops after raising HTTPException or returning the response.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4
item_id	N/A	0	1	5	-3
Condition (item_id < 1)	N/A	True	False	False	True

Key Moments - 2 Insights

Why does the function stop running after raising HTTPException?

Because raising HTTPException immediately interrupts the function and sends an error response, no further code runs after that (see Step 1 and Step 4 in execution_table).

What happens if the condition is false?

If the condition is false, the function returns a normal response dictionary with the item_id (see Step 2 and Step 3 in execution_table).

Visual Quiz - 3 Questions

Look at the execution table, what is the output when item_id is 0?

A HTTP 200 OK with empty body

B HTTP 400 Bad Request with detail 'Invalid ID'

C {'item_id': 0}

D Function returns None

💡 Hint

Check Step 1 in the execution_table where item_id is 0.

At which step does the condition item_id < 1 become false?

A Step 4

B Step 1

C Step 2

D None

💡 Hint

Look at the Condition column in execution_table for each step.

If we change the condition to item_id <= 0, how would the output change for item_id = 1?

A It would return {'item_id': 1}

B It would raise HTTPException

C It would return None

D It would cause a syntax error

💡 Hint

Check how the condition affects item_id values in variable_tracker and execution_table.

Concept Snapshot

Use HTTPException in FastAPI to send error responses.
Check a condition in your path operation.
If condition true, raise HTTPException with status_code and detail.
Otherwise, return normal response.
Raising HTTPException stops function execution and sends error to client.

Full Transcript

This example shows how FastAPI uses HTTPException to handle errors. When a request comes in with an item_id, the code checks if item_id is less than 1. If yes, it raises HTTPException with status 400 and a message 'Invalid ID'. This stops the function and sends an error response to the client. If the item_id is valid (1 or more), the function returns a dictionary with the item_id. The execution table shows different inputs and what happens step by step. The variable tracker shows how item_id and the condition change. Key moments explain why raising HTTPException stops the function and what happens when the condition is false. The quiz questions help check understanding of these steps.