JSON ছাড়া আপনি আর কী ধরনের প্রতিক্রিয়া ফেরত দিতে পারেন?

Question

Accepted Answer

FastAPI ডিফল্টরূপে JSON ফেরত দেয় (dicts, lists এবং Pydantic models সিরিয়ালাইজ করে), কিন্তু এটি বিভিন্ন প্রয়োজনের জন্য অনেক **প্রতিক্রিয়া প্রকার** সমর্থন করে — HTML, ফাইল, স্ট্রিম, রিডিরেক্ট এবং প্লেইন টেক্সট — `fastapi.responses` ক্লাসের মাধ্যমে। ## ডিফল্ট এবং সাধারণ প্রতিক্রিয়া ক্লাস ```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 ``` ## ফাইল পরিবেশন করা ```python @app.get("/download") def download(): return FileResponse( "report.pdf", media_type="application/pdf", filename="report.pdf", # prompts a download with this name ) ``` `FileResponse` ডিস্ক থেকে দক্ষতার সাথে একটি ফাইল পরিবেশন করে (হেডার, কন্টেন্ট টাইপ পরিচালনা করে) — ডাউনলোড, ছবি, উত্পাদিত নথির জন্য। ## বড় বা উত্পাদিত ডেটা স্ট্রিমিং করা ```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` একটি জেনারেটর থেকে ক্রমান্বয়ে ডেটা পাঠায় — **বড় বা ক্রমাগত-উত্পাদিত** ডেটার জন্য অপরিহার্য (বড় ফাইল, CSV রপ্তানি, লাইভ ফিড) যাতে আপনি সবকিছু একবারে মেমোরিতে লোড না করেন। (Server-Sent Events এর ভিত্তি হিসাবেও।) ## কাস্টম JSON এনকোডার (দ্রুত JSON) ```python from fastapi.responses import ORJSONResponse app = FastAPI(default_response_class=ORJSONResponse) # use orjson for faster JSON serialization ``` ## এটি কেন গুরুত্বপূর্ণ যদিও JSON বেশিরভাগ API প্রতিক্রিয়া কভার করে, বাস্তব অ্যাপ্লিকেশনগুলি প্রায়শই অন্যান্য সামগ্রী ফেরত দেওয়ার প্রয়োজন — এবং FastAPI এর প্রতিক্রিয়া প্রকারগুলি জানা আপনাকে এগুলি সঠিকভাবে পরিচালনা করতে দেয়। **`FileResponse`** ফাইল এবং ডাউনলোড পরিবেশনের জন্য প্রয়োজন (রিপোর্ট, ছবি, উত্পাদিত নথি), **`StreamingResponse`** বড় বা ক্রমাগত-উত্পাদিত ডেটার **মেমোরি-দক্ষ** ডেলিভারির জন্য গুরুত্বপূর্ণ (বড় রপ্তানি, ফাইল স্ট্রিমিং, সার্ভার-প্রেরিত ইভেন্ট — অংশ প্রদান করে পরিবর্তে মেমোরিতে সবকিছু বাফার করে যা স্কেলেবিলিটির জন্য গুরুত্বপূর্ণ), এবং `HTMLResponse`/`PlainTextResponse`/`RedirectResponse` অ-JSON কন্টেন্ট এবং নেভিগেশন পরিচালনা করে। উপলব্ধ প্রতিক্রিয়া প্রকার এবং বিশেষত কখন **স্ট্রিম** করতে হবে (বড় ডেটার জন্য, মেমোরি নিষ্কাশন এড়াতে) বনাম JSON ফেরত দিতে হবে তা বোঝা সহজ API তৈরির জন্য ব্যবহারিক জ্ঞান যা সাধারণ JSON এন্ডপয়েন্টের বাইরে যায় — ফাইল ডাউনলোড, ডেটা রপ্তানি এবং বড় বা রিয়েল-টাইম প্রতিক্রিয়া কভার করে যা বাস্তব-বিশ্ব অ্যাপ্লিকেশনে সাধারণ প্রয়োজনীয়তা।