Si i trajtoni gabimet dhe si rridhni përjashtime HTTP?

Question

Accepted Answer

FastAPI trajon gabimet duke **hedhur përjashtime** që ai i konverton në përgjigje të duhura HTTP. `HTTPException` mbron shumicën e rasteve; trajtuesit e përjashtime të personalizuara ju lejojnë të kontrolloni formatimin e gabimeve në mënyrë globale.

## Hedhja e HTTPException

```python
from fastapi import HTTPException

@app.get("/items/{id}")
def get_item(id: int):
    item = db.get(id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found")   # → 404 JSON response
    if not item.is_public:
        raise HTTPException(status_code=403, detail="Forbidden")
    return item
```

`raise HTTPException(status_code=..., detail=...)` është mënyra idiomatike për të kthyer një gabim — FastAPI prodhon një përgjigje JSON `{"detail": "..."}` me statusin e dhënë. `detail` mund të jetë çdo vlerë e serijalizueshme në JSON (string, dict, list).

## Gabimet e validimit janë automatike (422)

```text
When request data fails Pydantic validation, FastAPI AUTOMATICALLY returns a 422
with a structured list of exactly which fields are wrong — you write nothing.
```

## Trajtuesit e përjashtime të personalizuara (formatimi global)

```python
from fastapi import Request
from fastapi.responses import JSONResponse

class ItemNotFound(Exception):
    def __init__(self, item_id: int): self.item_id = item_id

@app.exception_handler(ItemNotFound)         # handle a custom exception type globally
def handle_not_found(request: Request, exc: ItemNotFound):
    return JSONResponse(status_code=404, content={"error": f"Item {exc.item_id} not found"})

@app.get("/items/{id}")
def get(id: int):
    raise ItemNotFound(id)        # raise your domain exception; the handler formats it
```

Trajtuesit e përjashtime të personalizuara ju lejojnë të hartëzoni përjashtimet tuaja (të domenit) në përgjigje, përqendrimi i formatimit të gabimeve dhe mbajte kodin e trajtuesit të pastër.

## Mbishkrim i trajtuesve të paracaktuar

```python
from fastapi.exceptions import RequestValidationError

@app.exception_handler(RequestValidationError)   # customize the 422 validation-error format
def validation_handler(request, exc):
    return JSONResponse(status_code=422, content={"errors": exc.errors()})
```

## Pse është e rëndësishme

Trajtimi i duhur i gabimeve është thelbësor për ndërtimin e API-ve të besueshme dhe profesionale, dhe qasja e FastAPI është e pastër dhe konsistente.

`HTTPException` idiomatike e bën të lehtë të kthehen përgjigje të duhura të gabimit me kode statusi të duhur dhe mesazhe — themelor për çdo pikë dore që mund të dështojë (nuk është gjetur, është ndaluar, është në gjendje të keqe).

Njësoj e vlefshme është se **gabimet e validimit trajtohen automatikisht** (dështimet e Pydantic prodhojnë përgjigje të strukturuara 422 pa kod nga ju), dhe se **trajtuesit e përjashtime të personalizuara** ju lejojnë të hartëzoni përjashtimet e domenit tuaj në përgjigje dhe të zbatoni një format të qëndrueshëm të gabimit në të gjithë API-në — përmirësimi i të dyja mirëmbajtjes (logjika e gabimit e përqendruar) dhe përvojës së klientit (format gabimi i parashikueshëm).

Kuptuimi i `HTTPException`, gabimet e validimit automatik dhe trajtuesit e personalizuara mbulojnë spektrin praktik të trajtimit të gabimeve, duke e bërë atë njohurit e rëndësishme për ndërtimin e API-ve të qëndrueshme.