Conas a shocraíonn tú cóid stádas agus ceanglóir?

Question

Accepted Answer

Filleann FastAPI `200 OK` de réir réamhshocraithe, ach rialaíonn tú an **cód stádais** (tríd an ndóchreachór nó an réad freagartha) agus **ceanglóir** nuair is gá duit iompar difriúil — tábhachtach do sheimantaic REST cuí.

## Cód stádais réamhshocraithe a shocrú ar an bhfréamh

```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):
    ...
```

Socrú an pharaiméadair `status_code` an stádas rath réamhshocraithe. Bheith ag úsáid na bhfostaithe `status` (m.sh. `status.HTTP_201_CREATED`) níos geal ná uimhreacha dhraíochta. Bheith na cóid cheart tábhachtach: `201` do chruthaithe, `204` do bhreith ar bhreith, etc.

## Cóid dhinimic stádais agus ceanglóir tríd an réad 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
```

A bhreith ar pharaiméadar `Response` a bhaint isteach tugann sé duit an cód stádais agus ceanglóir a shocrú **go coinníollach** ag am fhritháirimh.

## Earráidí: cuir HTTPException ar foluain

```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
```

Do fhreagairt earráidí, `raise HTTPException(...)` an bealach idiomateach — socrú an stádas, teachtaireacht JSON `detail`, agus ceanglóir roghnach.

## Toradh Response saincheaptha go díreach

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

## Cén fáth a bhfuil sé tábhachtach

Tá cóid stádais agus ceanglóir cuí riachtanach chun API REST a thógáil go soiléir agus go maith — braitheann cliant agus uirlisí ar sheimantaic HTTP caighdeánach (201 do chruthaithe, 404 do dhream nach bhfuil ann, 204 do bhreith ar bhreith, etc.), mar sin is cuid de chonradh API ar cháilíochta an cód ceart a thabhairt ar ais.

Tugann FastAPI smacht soiléir duit: `status_code` réamhshocraithe ar an bhfréamh don chás coiteann, an réad `Response` inchurtha don dinimiciúil cóid/ceanglóir, agus `HTTPException` mar an bealach idiomateach a chur in iúl earráidí leis an stádas cuí agus sonraí JSON.

Tuigint ar na meicníochtaí seo — agus na fonstaithe `status` a úsáid le soiléireacht — is eolas gach lá do API a thógáil a iomparann go soiléir agus a chumarsáid go soiléir lena n-úsáideoir.