Papaun cara kerja parameter jalur lan parameter query?

Question

Accepted Answer

FastAPI ngeluarake **parameter jalur** (bagian saka jalur URL) lan **parameter query** (sawise `?`) saka argumen fungsi, nggunakake jeneng pangkat kanggo ngowahi lan validasi otomatis.

## Parameter jalur — bagian saka URL

```python
@app.get("/items/{item_id}")        # {item_id} in the path
def get_item(item_id: int):          # matched by NAME; `int` converts & validates
    return {"item_id": item_id}
# GET /items/5 → item_id = 5 (int).  GET /items/abc → 422 error (not an int)
```

Parameter fungsi sing jenenge cocog karo `{placeholder}` ing jalur dadi **parameter jalur**. Jeneng pangkat (`int`) otomatis ngowahi string saka URL lan mulih kesalahan 422 sing jelas menawa ora cocog.

## Parameter query — kabeh sing liyane

```python
@app.get("/items")
def list_items(skip: int = 0, limit: int = 10, q: str | None = None):
    # parameters NOT in the path become QUERY parameters
    # GET /items?skip=20&limit=5&q=phone → skip=20, limit=5, q="phone"
    return {"skip": skip, "limit": limit, "q": q}
```

Parameter fungsi **ora** ing jalur dadi **parameter query**. Nilai standar ngadekne pilihan (`skip: int = 0`); `str | None = None` nggawe parameter query pilihan sing bisa null. Tanpa standar, kabutuhan.

## Kabutuhan vs pilihan

```python
def search(q: str):              # REQUIRED query param (no default) → ?q=... must be present
def search(q: str = ""):          # optional, defaults to ""
def search(q: str | None = None): # optional, defaults to None
```

## Nggabung loro-loro

```python
@app.get("/users/{user_id}/items")
def user_items(user_id: int, limit: int = 10):
    # user_id = path param, limit = query param — distinguished by the path
```

## Kenapa iki penting

Parameter jalur lan query iku cara titik dhasar nampa input saka URL — penting banget kanggo meh saben jalur API (ngambil sumber daya dening id, nyaring, paging, golek).

Cara FastAPI iku elegan lan alasan kunci apa dadi produktif: mung nyatakake parameter fungsi sing jeneng pangkat menehi sampeyan ngeluarake otomatis, **pagsisi tipe**, **validasi** (karo kesalahan 422 sing jelas ing input ala), lan semantika kabutuhan-versus-pilihan (liwat standar) — kabeh asale saka pangkat tipe Python standar, tanpa paring manual.

Ngerti beda (parameter jalur teka saka `{placeholders}`, kabeh liyane iku parameter query) lan cara standar ngendalakke kabolehan-pilihan iku kabutuhan ilmu asal-asalane saben dina kanggo bangun titik dhasar FastAPI.