api.py\n<\/strong>from fastapi import FastAPI\nfrom todo import todo_router\napp = FastAPI()\n\n@app.get(\"\/\")\nasync def welcome() -> dict:\n return { \"message\": \"Hello World\"}\napp.include_router(todo_router)\n<\/code><\/pre>\n<\/div>\n\n\n\n\nmodel.py\n<\/strong>from pydantic import BaseModel\nclass Todo(BaseModel):\n id: int\n item: str\n<\/code><\/pre>\n<\/div>\n\n\n\n\ntodo.py\n<\/strong>from fastapi import APIRouter\nfrom model import Todo\ntodo_router = APIRouter()\n\ntodo_list = []\n@todo_router.post(\"\/todo\")\nasync def add_todo(todo: Todo) -> dict:\n todo_list.append(todo)\n return {\"message\": \"Todo added successfully\"}\n@todo_router.get(\"\/todo\")\nasync def retrieve_todos() -> dict:\n return {\"todos\": todo_list}\n<\/code><\/pre>\n<\/div>\n<\/div>\n\n\n\nExplication sur le fonctionnement et l’utilisation de ce web service tr\u00e8s simple <\/p>\n\n\n\n
Pour d\u00e9marrer et activer le web service utilisez la commande suivante : <\/p>\n\n\n\n
uvicorn api:app --port 8005 --reload<\/strong>\nINFO: Will watch for changes in these directories: ['\/home\/ystroppa\/fastAPI']\nINFO: Uvicorn running on http:\/\/127.0.0.1:8005 (Press CTRL+C to quit)\nINFO: Started reloader process [22901] using StatReload\nINFO: Started server process [22903]\nINFO: Waiting for application startup.\nINFO: Application startup complete.\n<\/code><\/pre>\n\n\n\nUtilisation et v\u00e9rification du fonctionnement <\/p>\n\n\n\n
A partir d’un autre terminal, on peut utiliser les instructions suivantes : <\/p>\n\n\n\n
Pour un ajout qui ne respecte par le mod\u00e8le d\u00e9finie <\/p>\n\n\n\n
curl -X 'POST' 'http:\/\/127.0.0.1:8000\/todo' -H 'accept: application\/json' -H 'Content-Type: application\/json' -d '{}'<\/code><\/pre>\n\n\n\n{\"detail\":[{\"type\":\"missing\",\"loc\":[\"body\",\"id\"],\"msg\":\"Field required\",\"input\":{}},{\"type\":\"missing\",\"loc\":[\"body\",\"item\"],\"msg\":\"Field required\",\"input\":{}}]}<\/code><\/pre>\n\n\n\nPour un ajout d’un nouvel item qui respecte le mod\u00e8le d\u00e9finie <\/p>\n\n\n\n
curl -X 'POST' 'http:\/\/127.0.0.1:8005\/todo' -H 'accept: application\/json' -H 'Content-Type: application\/json' -d '{\"id\": 2,\"item\": \"Validation models help with input types\"}'\n<\/code><\/pre>\n\n\n\n{\"message\":\"Todo added successfully\"}<\/code><\/pre>\n\n\n\nPour lister les items existants dans la dictionnaire interne <\/p>\n\n\n\n
curl http:\/\/0.0.0.0:8005\/todo<\/code><\/pre>\n\n\n\n{\"todos\":[{\"id\":2,\"item\":\"Validation models help with input types\"},{\"id\":2,\"item\":\"Validation models help with input types\"}]}<\/code><\/pre>\n\n\n\nPetite explication : la v\u00e9rification et le contr\u00f4le de l’envoie des donn\u00e9es se fait \u00e0 l’aide de pydantic qui permet de convertir et de contr\u00f4ler les donn\u00e9es transmises.<\/p>\n\n\n\n
On peut \u00e9tendre le concept des mod\u00e8les par des structures nested (imbriqu\u00e9es) de la fa\u00e7on suivante : <\/p>\n\n\n\n
class Item(BaseModel)\n item: str\n status: str\nclass Todo(BaseModel)\n id: int\n item: Item<\/code><\/pre>\n\n\n\nCe qui nous permetrait de cr\u00e9er des structures de type : <\/p>\n\n\n\n
{\n \"id\": 1,\n \"item\": {\n \"item\": \"Nested models\",\n \"Status\": \"completed\"\n }\n}<\/code><\/pre>\n\n\n\nChemin d’acc\u00e8s et requ\u00eate : si on souhaite extraire non pas la liste compl\u00e8te mais un item \u00e0 partir de son id il nous suffit de red\u00e9finir un chemin sp\u00e9cifique et d\u00e9di\u00e9 dans le fichier todo.py ce qui nous donne <\/p>\n\n\n\n
from fastapi import APIRouter, Path<\/strong>\nfrom model import Todo\ntodo_router = APIRouter()\ntodo_list = []\n@todo_router.post(\"\/todo\")\nasync def add_todo(todo: Todo) -> dict:\n todo_list.append(todo)\n return {\n \"message\": \"Todo added successfully.\"\n }\n@todo_router.get(\"\/todo\")\nasync def retrieve_todo() -> dict:\n return {\n \"todos\": todo_list\n }\n@todo_router.get(\"\/todo\/{todo_id}\")\nasync def get_single_todo(todo_id: int = Path(..., title=\"The ID of the todo to retrieve.\")) -> dict:\n for todo in todo_list:\n if todo.id == todo_id:\n return {\n \"todo\": todo\n }\n return {\n \"message\": \"Todo with supplied ID doesn't exist.\"\n }<\/strong><\/code><\/pre>\n\n\n\nEt pour r\u00e9cup\u00e9rer le contenu : <\/p>\n\n\n\n
curl -X 'GET' 'http:\/\/127.0.0.1:8005\/todo\/2' -H 'accept: application\/json'<\/code><\/pre>\n\n\n\nOn a de fa\u00e7on implicite swagger pour les acc\u00e8s aux descripteurs des fonctions <\/p>\n\n\n\n
On y acc\u00e8de par l’url suivante : http:\/\/localhost:8005\/docs#\/<\/a> <\/p>\n\n\n
![\"\"](\"https:\/\/spgoo.org\/wp-content\/uploads\/2026\/01\/Capture-du-2026-01-06-16-40-00-1024x442.png\")
<\/figure>\n<\/div>\n\n\n