JSON-க்கு அப்பால் என்ன response types-ஐ நீங்கள் return செய்யலாம்?

Question

Accepted Answer

FastAPI இயல்பாகவே JSON-ஐ return செய்கிறது (dicts, lists, மற்றும் Pydantic models-ஐ serialize செய்கிறது), ஆனால் இது வெவ்வேறு தேவைகளுக்கு பல்வேறு **response types**-ஐ ஆதரிக்கிறது — HTML, files, streams, redirects, மற்றும் plain text — `fastapi.responses` classes வழியாக. ## இயல்புநிலை மற்றும் பொதுவான response classes ```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 ``` ## Files-ஐ serve செய்தல் ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` disk-இலிருந்து ஒரு file-ஐ திறமையாக serve செய்கிறது (headers, content type-ஐ கையாளுகிறது) — downloads, images, generated documents-க்காக. ## பெரிய அல்லது generate செய்யப்பட்ட data-ஐ streaming செய்தல் ```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` ஒரு generator-இலிருந்து data-ஐ படிப்படியாக அனுப்புகிறது — **பெரிய அல்லது தொடர்ந்து generate செய்யப்படும்** data-க்கு (பெரிய files, CSV exports, live feeds) அவசியமானது, இதனால் நீங்கள் அதை ஒரே நேரத்தில் memory-இல் முழுவதுமாக load செய்ய வேண்டியதில்லை. (Server-Sent Events-இன் அடிப்படையும் இதுவே.) ## Custom JSON encoders (வேகமான JSON) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## இது ஏன் முக்கியம் JSON பெரும்பாலான API responses-ஐ உள்ளடக்கினாலும், உண்மையான applications பெரும்பாலும் வேறு content-ஐ return செய்ய வேண்டியிருக்கிறது — மேலும் FastAPI-இன் response types-ஐ அறிவது இவற்றை சரியாக கையாள உங்களை அனுமதிக்கிறது. **`FileResponse`** files மற்றும் downloads-ஐ serve செய்வதற்கு (reports, images, generated documents) தேவைப்படுகிறது, **`StreamingResponse`** பெரிய அல்லது தொடர்ந்து generate செய்யப்படும் data-இன் **memory-திறமையான** வழங்கலுக்கு (பெரிய exports, file streaming, server-sent events — எல்லாவற்றையும் memory-இல் buffer செய்வதற்குப் பதிலாக chunks-ஐ yield செய்தல், இது scalability-க்கு முக்கியம்) முக்கியம், மேலும் `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` non-JSON content மற்றும் navigation-ஐ கையாளுகிறது. கிடைக்கக்கூடிய response types-ஐ புரிந்துகொள்வதும், குறிப்பாக எப்போது **stream** செய்வது (பெரிய data-க்கு, memory தீர்ந்துபோவதைத் தவிர்க்க) versus JSON-ஐ return செய்வது என்பதும், எளிய JSON endpoints-க்கு அப்பால் செல்லும் APIs-ஐ உருவாக்குவதற்கான நடைமுறை அறிவாகும் — file downloads, data exports, மற்றும் real-world applications-இல் பொதுவான தேவைகளான பெரிய அல்லது real-time responses-ஐ உள்ளடக்குகிறது.