Cad iad na cineálacha freagra is féidir leat a thabhairt seachas JSON?

Question

Accepted Answer

Filleann FastAPI JSON de réir réamhshocraithe (ag srianpadh dicts, liostanna, agus samhlacha Pydantic), ach tacaíonn sé le go leor cineálacha freagra **eile** do riachtanais éagsúla — HTML, comhaid, sruthanna, athdhírithe, agus gnáth-théacs — trí na ranganna `fastapi.responses`. ## Na ranganna freagra réamhshocraithe agus coitianta ```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 ``` ## Comhaid a fheidhmiú ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` Freastalónn `FileResponse` ar chomhad ó dhiosca go héifeachtach (ag láimhseáil ceanntásc, cineál ábhair) — do dhílsí, íomhánna, doiciméid ghinte. ## Sonraí móra nó ghinte a shruthú ```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") ``` Cuireann `StreamingResponse` sonraí ar aghaidh go neamh-dhíreach ó ghenerator — riachtanach do **shonraí móra nó athleanúnacha ghinte** (comhaid mhóra, onnmhairí CSV, fothain bheo) ionas nach bheidh siad uilig i do chuimhne ar an am céanna. (Freisin bunús na Server-Sent Events.) ## Ionchóditheoirí JSON saincheaptha (JSON níos tapa) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## Cén fáth a bhíonn tábhacht ann Cé go gclúdaíonn JSON an chuid is mó de fhreagraí API, is minic a bhíonn gá ag fíor-thaifeadtais bhonn do dhá rud eile a thabhairt ar ais — agus má thuigeann tú cineálacha freagra FastAPI, beidh tú ábalta na nithe seo a láimhseáil i gceart. Tá **`FileResponse`** de dhíth chun comhaid agus dílsí a fheidhmiú (tuarascálacha, íomhánna, doiciméid ghinte), tá **`StreamingResponse`** tábhachtach chun soláthair **éifeachtach cuimhne** de shonraí móra nó athleanúnacha ghinte (onnmhairí móra, sruthú comhaid, events a sheoladh ón bhfreastalaí — ag toiliú píosaí seachas gach rud a bhualadh sa chuimhne, rud a bhíonn dóigh ar scálúchán), agus láimhséalann `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` ábhar neamh-JSON agus nascleanúint. A thuiscint a bheith agat ar na cineálacha freagra atá ar fáil, agus go háirithe cathain ba chóir duit a **shruthú** (do shonraí móra, chun leith na cuimhne a sheachaint) i gcomparáid leis an JSON a thabhairt ar ais is eolas praiticiúil a bhíonn ann chun APIs a thógáil a théann thairis na críochfoirtí simplí JSON — ag cúmhdach díosú comhaid, onnmhairí sonraí, agus freagraí móra nó fíor-aimseartha atá ina bhforais choitianta in fhíor-thaifeadtais.