Kepiye cara FastAPI nghasilake dokumentasi otomatis?

Question

Accepted Answer

FastAPI **otomatis nghasilake dokumentasi API interaktif** saka kode mu — route mu, parameter, lan model Pydantic diowahi dadi skema OpenAPI, sing nduweni loro UI dokumentasi sing bisa dijelajahi (Swagger UI lan ReDoc) tanpa usaha tambahan.

## Sampeyan entuk dokumentasi gratis

```python
class Item(BaseModel):
    name: str
    price: float = Field(gt=0, description="Price in USD")

@app.post("/items", tags=["items"], summary="Create an item")
def create_item(item: Item):
    """Create a new item with a name and price."""   # docstring → endpoint description
    return item
```

Yamene mung nulis endpoint lan model sing ketik, FastAPI ngasilake dokumentasi lengkap — ora ana file dokumentasi sing kapisah kanggo ditulis utawa dijaga.

## Loro UI dokumentasi sing wis dadi bawaan

```text
/docs   → Swagger UI — interactive: browse endpoints AND test them in the browser
          (fill in parameters, send requests, see responses live)
/redoc  → ReDoc — a clean, readable reference-style view
/openapi.json → the raw OpenAPI schema (usable to generate client SDKs, etc.)
```

Mbukak `/docs` lan sampeyan bisa njelajahi saben endpoint, weruh parameter sing kudu lan wujud response, lan **ngirim request nyata** langsung saka browser — sangat berharga sajrone development lan kanggo konsumen API.

## Saka endi isi dokumentasi teka

```text
Route decorators → paths, HTTP methods, tags, summaries
Type hints       → parameter types, required/optional
Pydantic models  → request/response schemas, field constraints & descriptions
Docstrings       → endpoint descriptions
Field(..., description=, example=) → field-level docs and examples
```

Semua asale saka kode sing wis sampeyan tulis — dokumentasi tetep otomatis **nyinkron** karo implementasi.

## Nambahi dokumentasi

```python
app = FastAPI(title="My API", version="1.0", description="...")
@app.get("/x", response_model=Item, responses={404: {"description": "Not found"}})
```

## Apa sebabe penting

Dokumentasi interaktif otomatis minangka salah sawijining fitur FastAPI sing paling dirayani lan alasan utama kanggo populeritate.

Karena dokumentasi digawe langsung saka kode mu (route, type hint, model Pydantic, docstring), dokumentasi iku **nyinkron** karo implementasi nyata — ngilangke masalah kronis dokumentasi sing ketinggalan jaman, sing ngganggu dokumentasi sing ditulis tangan.

Swagger UI interaktif (`/docs`) entuk nduweni developer lan konsumen API jelajahi lan **test endpoint langsung ing browser**, nambahi pengalaman developer lan nyuda gegripane integrasi.

Skema OpenAPI sing dibuat uga bisa ngarahake pembuatan SDK klien lan pengujian kontrak.

Entuk dokumentasi API sing profesional, akurat, lan interaktif dasarane gratis — yamene mung nulis kode sing ketip — minangka kalahjayaning produktivitas lan kualitas sing penting, dadi iki minangka kapabilitas FastAPI sing penting lan nglengkapi.