Kif issettja kodiċi ta' status u headers?

Question

Accepted Answer

FastAPI jirritorna `200 OK` b'mod default, iżda tista' tikontrollà l-**kodiċi ta' status** (permezz tad-decorator jew l-oggett tar-rispons) u l-**headers** meta trid imġibiet differenti — importanti għal semantika REST korretta.

## Issettja kodiċi ta' status default fuq ir-rotta

```python
from fastapi import status

@app.post("/items", status_code=status.HTTP_201_CREATED)   # 201 for resource creation
def create_item(item: Item):
    return item                                             # returns with 201

@app.delete("/items/{id}", status_code=status.HTTP_204_NO_CONTENT)  # 204
def delete_item(id: int):
    ...
```

Il-parametru tad-decorator `status_code` jissettja l-istatus tas-suċċess default. L-użu tal-kostanti `status` (eż. `status.HTTP_201_CREATED`) huwa aktar ċar minn numri magikali. Kodiċi korretti huma importanti: `201` għal maħluq, `204` għal ebda kontenut, eċċ.

## Kodiċi ta' status dinamiki u headers permezz ta' oggett Response

```python
from fastapi import Response

@app.get("/items/{id}")
def get_item(id: int, response: Response):
    item = db.get(id)
    if not item:
        response.status_code = status.HTTP_404_NOT_FOUND   # set dynamically
        return {"error": "not found"}
    response.headers["X-Custom"] = "value"                  # set a custom header
    return item
```

L-injezzjoni ta' parametru `Response` tippermettik issettja l-kodiċi ta' status u headers **b'mod kondizzjonali** fuq runtime.

## Żbalji: raise 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",
                            headers={"X-Error": "NotFound"})   # status + detail + headers
    return item
```

Għal risponsi ta' żball, `raise HTTPException(...)` hija l-mod idiomatiku — tissettja l-istatus, messaġġ JSON `detail`, u headers opzjonali.

## Ritorn ta' Response personalizzat direttament

```python
from fastapi.responses import JSONResponse
return JSONResponse(content={...}, status_code=202, headers={"X-Custom": "v"})
```

## Għaliex hija importanti

Kodiċi ta' status u headers korretti huma essenzjali għall-bini ta' API REST korretti u li jitħaddmu sew — il-kliyenti u l-għodod jiddependu fuq semantika HTTP standard (201 għal maħluq, 404 għal mhux misjub, 204 għal ebda kontenut, eċċ.), u għalhekk jirritorna kodiċi korrett hija parti mill-kuntratt tal-kwalità tal-API.

FastAPI tgħoti kontroll ċlean: `status_code` default fuq ir-rotta għall-każ komuni, oggett `Response` injezzjonabbli għal kodiċi/headers dinamiki, u `HTTPException` bħala l-mod idiomatiku biex tissegna żbalji b'status xieraq u dettalji JSON.

L-għarfien ta' dawn il-mekkaniżmi — u l-użu tal-kostanti `status` għal ċarezza — hija għarfien ta' kull jum għall-bini ta' API li jitħaddmu sew u li jikkomunikaw b'mod ċar mal-konsumaturi tagħhom.