Kaip nustatyti maršrutus (path operacijas)?

Question

Accepted Answer

FastAPI, **path operacija** yra maršrutas — funkcija, papuošta HTTP metodo dekoratoriumi (`@app.get`, `@app.post` ir kt.), kuri tvarko prašymus kelyje. Funkcijos grąžinta reikšmė automatiškai serializuojama į JSON.

## Maršrutų nustatymas kiekvienam HTTP metodui

```python
from fastapi import FastAPI
app = FastAPI()

@app.get("/items")                # GET /items
def list_items():
    return [{"id": 1}, {"id": 2}]  # dict/list → automatically JSON-serialized

@app.get("/items/{item_id}")      # GET /items/5 — path parameter
def get_item(item_id: int):        # type hint converts "5" → int (and validates)
    return {"id": item_id}

@app.post("/items")               # POST /items
def create_item(item: Item):
    return item

@app.put("/items/{item_id}")      # PUT, PATCH, DELETE work the same way
@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    return {"deleted": item_id}
```

Kiekvienas dekoratorius nusustato HTTP metodą + kelią su apdorojikliu. Funkcijos pavadinimas yra jūsų; dekoratorius nurodo maršrutą. Grąžinti dict/list/Pydantic modeliai automatiškai serializuojami į JSON — nereikalingas rankinis `json.dumps`.

## Tvarka svarbi sutapatinantiems keliams

```python
@app.get("/users/me")            # ✅ specific route FIRST
def read_me(): ...
@app.get("/users/{user_id}")     # dynamic AFTER — else "me" matches {user_id}
def read_user(user_id: int): ...
```

FastAPI nusutinka maršrutus deklaracijos tvarka, todėl statiniai keliai turi būti prieš dinaminius.

## Operacijos metaduomenys (grąžina dokumentaciją)

```python
@app.get("/items", tags=["items"], summary="List items", status_code=200)
def list_items(): ...
```

Dekoratoriaus parametrai (`tags`, `summary`, `status_code`, `response_model`) nustato elgesį ir praturtina automatiškai sugeneruotą dokumentaciją.

## Kodėl tai svarbu

Kelių operacijos yra kiekvienos FastAPI programos pagrindas — jos apibrėžia jūsų API galutines taškus ir kaip tvarkomos užklausos.

Supratimas apie dekoratoriaus-per-HTTP-metodą šabloną, kad grąžintosios reikšmės automatiškai serializuojamos į JSON (be šablono kodo), kad tipo nurodymai parametrų naudojami konversijai ir patikrai, ir kad maršruto tvarka svarbi sutapatinantiems keliams, yra esminis kasdieninis žinios norint sukurti bet kurį galutinį tašką.

Dekoratoriaus metaduomenys taip pat maitina FastAPI automatinę dokumentaciją, susieidami maršrutus tiesiai su dokumentacija.

Tai pirmas ir pats pagrindinis dalykas, kurį reikia įvaldyti FastAPI.