Wadanne nau'ikan amsa za ka iya bayarwa jiya ga JSON?

Question

Accepted Answer

FastAPI yana ba da JSON ta tsakiya (yana jera dicts, lists, da Pydantic models), amma yana goyan bayan wasu **nau'ikan amsa** da yawa don bukatun daban-daban — HTML, fayiloli, streams, redirects, da zabon rubutu — ta hanyar `fastapi.responses` classes. ## Tsakiya da ruwan gida na nau'ikan amsa ```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 ``` ## Yin aiki da fayiloli ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` yana gajiya yin aiki da fayilo daga disk (tana gudanar da headers, nau'in abun ciki) — ga saukar, hotuna, gurnaka da aka samarwa. ## Saukar da babbar bayani ko da jiya ba ```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` yana aika da bayani a hanya — shi ne muhimmi don **babbar ko bayani da ke bada-badawa** (manyan fayiloli, CSV ido, abubuwan kasua) saboda ba za ka loda shi duka a cikin alaƙa lokaci ɗaya. (Kuma tushe na Server-Sent Events.) ## JSON encoders na musamman (JSON mafi sauri) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## Me yasa ya haɗa Wadansu JSON yana rufe yawancin amsan API, aini-aini aikace-aikacen gida sau da yawa buƙatun ba da sauran abun ciki — kuma sanin nau'ikan amsa na FastAPI yana ba ka damar taka hanyoyin daidai. **`FileResponse`** ana buƙatarshi don yin aiki da fayiloli da saukar (rahotanni, hotuna, gurnaka da aka samarwa), **`StreamingResponse`** yana muhimmi don **bukatar alaƙa** na bayar da babbar ko bayani da ke bada-badawa (babbar ido, saukar fayilo, abubuwan kasua — yin haba maimakon ɗauko duka a cikin alaƙa, wanda ya haɗa don ƙimar sikeli), da `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` yana kula da abun ciki da ba-JSON da kuma gida. Sanin nau'ikan amsa da aka samu kuma musamman lokacin da ya kamata ka **saukar** (don babbar bayani, don guje wa alaƙa) matashi ƙaita da ba da JSON yana ilimi na aiki don gina APIs da ke wuce gida kamar zabon JSON — taka fayiloli saukar, ido iro, da babbar ko abubuwan kasua amsa da yawa buƙatun haƙiƙa a jiya-jiya.