Τι τύπους απαντήσεων μπορείτε να επιστρέψετε πέρα από 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 endpoints — που καλύπτουν λήψεις αρχείων, εξαγωγές δεδομένων και μεγάλες ή απαντήσεις σε πραγματικό χρόνο που είναι κοινές απαιτήσεις σε πραγματικές εφαρμογές.