Piye carane sampeyan nyusun app gedhe nganggo APIRouter?

Question

Accepted Answer

**`APIRouter`** ngidini sampeyan pambagé app FastAPI gedhe dadi pirang modul — saben router nglumpukké endpoint sing elok (contone, kabeh rute `/users`), lan app utama ngikutsertaké. Iki njaga codebase sing berkembang supaya terorganisir lan bisa dirawat.

## Ngedefinisèn router ing modul dhewe

```python
# routers/users.py
from fastapi import APIRouter

router = APIRouter(
    prefix="/users",          # all routes here start with /users
    tags=["users"],           # grouped under "users" in the docs
)

@router.get("/")              # GET /users/
def list_users(): ...

@router.get("/{user_id}")     # GET /users/{user_id}
def get_user(user_id: int): ...
```

`APIRouter` kaya mini-app — sampeyan ngedefinisèn path operation ing jero nganggo decorator sing padha, lan `prefix` ditrapkeun kanggo kabeh.

## Ngikutsertaké router ing app utama

```python
# main.py
from fastapi import FastAPI
from routers import users, items, auth

app = FastAPI()
app.include_router(users.router)     # mounts /users/* endpoints
app.include_router(items.router)
app.include_router(auth.router)
```

`app.include_router()` ngasoké endpoint saben router menyang app utama — nggabungké API lengkap saka potongan modular.

## Struktur proyék khas

```text
app/
  main.py              # creates the app, includes routers
  routers/
    users.py           # APIRouter for /users
    items.py           # APIRouter for /items
    auth.py            # APIRouter for /auth
  models.py            # Pydantic models
  database.py          # DB setup
  dependencies.py      # shared dependencies
```

Saben fitur/domain oleh modul router dhewe — njaga rute sing elok, lan codebase sing terorganisir apik.

## Dependensi lan konfigurasi tingkat router

```python
router = APIRouter(
    prefix="/admin",
    dependencies=[Depends(verify_admin)],   # apply a dependency to ALL routes in the router
)
# you can also nest routers via include_router on a router
```

Router bisa nggawa dependensi sing dibagikeun (contone, njaluk autentikasi admin kanggo kabeh rute) — ditrapkeun kanggo kabeh endpoint ing sawijining wektu.

## Apa menawa iku penting

`APIRouter` penting banget kanggo ngwangun apa-apa sing luwih saka app FastAPI sing simpel — tanpa iki, kabeh endpoint bakal manggon ing setunggal file, kang dadi angel diurus nalika API berkembang.

Paham iki penting kanggo **organisasi kode lan pemeliharaan**: pambagé endpoint dadi modul router adhedhasar fitur (pengguna, item, autentikasi) njaga kode sing elok babar pisan, nggawe proyék gampang dinavigasi, lan ngidini tim tumindak ing area beda kanthi independen.

`prefix` lan `tags` njaga rute lan dokumentasi terorganisir, lan **dependensi tingkat router** (kaya nuntut autentikasi admin kanggo kabeh grup) menehi prilaku bersih tingkat grup.

Striktur modular iki práktik standar kanggo aplikasi FastAPI nyata, nggawe `APIRouter` lan pola organisasi proyék sabendinipun penting, pengetahuan praktis-penting kanggo ngwangun API sing scalable lan bisa dirawat.