Je, unajifanya routes (operesheni za njia) vipi?

Question

Accepted Answer

Katika FastAPI, **path operation** ni route — kazi iliyosanifiwa na kichwa cha njia ya HTTP (`@app.get`, `@app.post`, n.k.) inayobadilisha ombi la njia. Thamani ya kurudi ya kazi inabadilishwa otomatiki kuwa JSON.

## Kufafanua routes kwa kila njia ya HTTP

```python
from fastapi import FastAPI
app = FastAPI()

@app.get("/items")                # GET /items
def list_items():
    return [{"id": 1}, {"id": 2}]  # dict/list → automatically JSON-serialized

@app.get("/items/{item_id}")      # GET /items/5 — path parameter
def get_item(item_id: int):        # type hint converts "5" → int (and validates)
    return {"id": item_id}

@app.post("/items")               # POST /items
def create_item(item: Item):
    return item

@app.put("/items/{item_id}")      # PUT, PATCH, DELETE work the same way
@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    return {"deleted": item_id}
```

Kila kichwa kinaunganisha njia ya HTTP + njia kwa mshughulikaji. Jina la kazi ni lako; kichwa kinafafanua route. Dicts/orodha/mifano ya Pydantic inayorudi inabadilishwa otomatiki kuwa JSON — hakuna `json.dumps` ya mwenyewe.

## Mpangilio ni muhimu kwa njia zinazokatiana

```python
@app.get("/users/me")            # ✅ specific route FIRST
def read_me(): ...
@app.get("/users/{user_id}")     # dynamic AFTER — else "me" matches {user_id}
def read_user(user_id: int): ...
```

FastAPI inaunganisha routes kwa mpangilio wa kutangaza, kwa hivyo weka njia za statiki kabla ya zile za nguvu.

## Metadata ya operesheni (inayoharaka nyaraka)

```python
@app.get("/items", tags=["items"], summary="List items", status_code=200)
def list_items(): ...
```

Parametra za kichwa (`tags`, `summary`, `status_code`, `response_model`) husanidi tabia na kuimarisha hati iliyojumuishwa otomatiki.

## Kwa nini ni muhimu

Operesheni za njia ni msingi wa kila programu ya FastAPI — zinafafanua endpoints za API yako na jinsi ombi linabadilishwa.

Kuelezemana na muundo wa kichwa-kwa-njia ya HTTP, kuwa thamani za kurudi zinabadilishwa otomatiki kuwa JSON (bila boilerplate), kuwa vidokezo vya aina kwenye vigezo vinaoharaka ubadilisho na uthibitisho, na kuwa mpangilio wa route ni muhimu kwa njia zinazokatiana ni elimu muhimu ya kila siku kwa kujenga endpoint yoyote.

Metadata ya kichwa pia inapasha nyaraka otomatiki ya FastAPI, ikiainisha routes moja kwa moja kwa nyaraka.

Hii ni kitu cha kwanza na cha msingi zaidi cha kusoma katika FastAPI.