Koje vrste odgovora možete vratiti osim JSON-a?

Question

Accepted Answer

FastAPI vraća JSON prema zadanom postavkama (serijalizirajući dict, liste i Pydantic modele), ali podržava mnoge druge **vrste odgovora** za različite potrebe — HTML, datoteke, tokove, preusmjeravanja i obični tekst — kroz `fastapi.responses` klase. ## Zadane i česte klase odgovora ```python from fastapi.responses import ( JSONResponse, HTMLResponse, PlainTextResponse, RedirectResponse, FileResponse, StreamingResponse, ) @app.get("/json") def j(): return {"key": "value"} # default → JSON @app.get("/html", response_class=HTMLResponse) def h(): return "

Hello

" # serve HTML @app.get("/text", response_class=PlainTextResponse) def t(): return "plain text" @app.get("/go") def g(): return RedirectResponse(url="/new-location") # 307 redirect ``` ## Posluživanje datoteka ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` učinkovito poslužuje datoteku s diska (rukujući zaglavljem, vrstom sadržaja) — za preuzimanja, slike, generirane dokumente. ## Streaming velikih ili generiranih podataka ```python @app.get("/stream") def stream(): def generate(): for i in range(1000000): yield f"line {i} " # yield chunks — NOT all loaded into memory return StreamingResponse(generate(), media_type="text/plain") ``` `StreamingResponse` šalje podatke inkrementalno iz generatora — ključno za **velike ili kontinuirano-generirane** podatke (velike datoteke, CSV izvozne datoteke, užive prenose) kako ne biste učitali sve to odjednom u memoriju. (Također osnova Server-Sent Eventsa.) ## Prilagođeni JSON koderi (brži JSON) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## Zašto je to važno Dok JSON pokriva većinu API odgovora, prave aplikacije često trebaju vratiti drugačitav sadržaj — i poznavanje FastAPI-jevih vrsta odgovora omogućuje vam da to pravilno radite. **`FileResponse`** je potreban za posluživanje datoteka i preuzimanja (izvještaji, slike, generirani dokumenti), **`StreamingResponse`** je važan za **memorijski učinkovitu** isporuku velikih ili kontinuirano-generiranih podataka (veliki izvozni podaci, streaming datoteka, server-sent eventi — generiranje dijelova umjesto spremanja svega u memoriju, što je važno za skalabilnost), a `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` rukuju sadržajem koji nije JSON i navigacijom. Razumijevanje dostupnih vrsta odgovora i posebno kada **strimati** (za velike podatke, kako bi se izbjegla iscrpljenost memorije) nasuprot vraćanju JSON-a je praktično znanje za gradnju API-ja koji idu dalje od jednostavnih JSON krajnjih točaka — pokrivajući preuzimanja datoteka, izvoz podataka i velike ili real-time odgovore koji su česta zahtjeva u primjenama iz stvarnog svijeta.