Piye cara nyetel kode status lan header?

Question

Accepted Answer

FastAPI bali `200 OK` kanthi baku, nanging sampeyan bisa ngontrol **kode status** (liwat dekorator utawa obyek response) lan **header** nalika sampeyan butuh perilaku beda — penting kanggo semantika REST sing bener.

## Ngatur kode status baku ing rute

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

Parameter dekorator `status_code` nyetel status sukses baku. Nggunakake konstanta `status` (contone `status.HTTP_201_CREATED`) luwih cetha tinimbang nomer ajaib. Kode sing bener penting: `201` kanggo digawe, `204` kanggo ora ana konten, lsp.

## Kode status dinamis lan header liwat obyek 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
```

Nyuntiki parameter `Response` ngidini sampeyan ngatur kode status lan header **kanthi syarat** ing runtime.

## Kesalahan: 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
```

Untuk respons kesalahan, `raise HTTPException(...)` minangka cara idiomatis — menetapkan status, pesen JSON `detail`, lan header opsional.

## Bali Response khusus langsung

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

## Mengapa penting

Kode status lan header sing bener ndewe pentinge banget kanggo membangun REST API sing bener, berperilaku anyar — klien lan alat ngandelake semantika HTTP standar (201 kanggo digawe, 404 kanggo ora ditemokake, 204 kanggo ora ana konten, lsp.), mula mulih kode sing bener minangka bagian saka kontrak API sing berkualitas.

FastAPI menehi kontrol bersih: `status_code` baku ing rute kanggo kasus umum, obyek `Response` injeksion kanggo kode dinamis/header, lan `HTTPException` minangka cara idiomatis kanggo nandai kesalahan kanthi status sing tepat lan detail JSON.

Mangerteni mekanisme iki — lan nggunakake konstanta `status` kanggo kajelasan — minangka pengetahuan araw-arahan kanggo membangun API sing berperilaku bener lan komunikasi jelas karo konsumen.