Flask Request Object API

Die Request-Klasse kapselt alle Informationen über die vom Client gesendete HTTP-Anfrage.

Durchfrom flask import requestImportiere das Proxy-Objekt und verwende es direkt in View-Funktionen.


Kurzreferenz für gängige Attribute

Eigenschaft Type Beschreibung Beispielwert
method str HTTP-Anfragemethode "GET"、"POST"
path str URL-Pfadteil (ohne Domain und Query-String) "/search"
full_path str Pfad + Query-String "/search?q=example"
url str Vollständige Anfrage-URL (ohne Query-String) "http://localhost:5000/search"
base_url str Wie url, jedoch ohne den abschließenden Query-String. "http://localhost:5000/search"
url_root str Domain + Anwendungsstammpfad "http://localhost:5000/"
host str Host-Header, einschließlich Port "localhost:5000"
host_url str scheme + host + Anwendungsstamm "http://localhost:5000/"
scheme str Protokoll "http"、"https"
remote_addr str Client-IP-Adresse "127.0.0.1"
endpoint str Der übereinstimmende Routen-Endpunkt "index"、"blog.show"
url_rule Regel Übereinstimmendes Routenregel-Objekt Werkzeug Rule-Instanz
view_args dict Dynamische Variablen in der URL {"post_id": 42}
blueprint str Aktueller Blueprint-Name "auth"、"blog"
blueprints Liste Aktuelle Liste der übereinstimmenden Blueprint-Ebenen ["auth"]
is_json bool Ob der Content-Type der Anfrage JSON ist True / False

Anfragedaten abrufen

Attribute/Methoden Type Beschreibung
args MultiDict URL-Abfrageparameter. Zugriff auf /search?q=flask → request.args.get("q")
Form MultiDict POST-Formulardaten (application/x-www-form-urlencoded oder multipart/form-data)
json dict / None JSON-Anfragekörper (in ein Python-Objekt geparst). Gibt None zurück, wenn die Anfrage nicht JSON ist.
data bytes Rohdaten des Anfragekörpers
files FileMultiDict Hochgeladene Datei. request.files["file"] gibt ein FileStorage-Objekt zurück
cookies dict Vom Client gesendetes Cookie
headers Headers Anfrage-Header. Unterstützt mehrere Zugriffsmethoden
get_json(force=False, silent=False, cache=True) — Den JSON-Anfragekörper parsen. force erzwingt das Parsen von Nicht-JSON-Typen, silent gibt bei Fehler None zurück

Paarargs、formusw. MultiDict-Typen, immer verwenden..get(key, default)Methode zum Abrufen des Werts. Direkt verwenden.request.args["key"]Der Zugriff auf einen nicht existierenden Schlüssel löst einen KeyError aus (gibt einen 400-Fehler zurück).


Attribute der Inhaltsaushandlung

Attribute/Methoden Beschreibung
accept_mimetypes Liste der vom Client akzeptierten MIME-Typen (MIMEAccept-Objekt).
accept_charsets Vom Client akzeptierter Zeichensatz
accept_encodings Vom Client akzeptierte Kodierung
accept_languages Vom Client akzeptierte Sprache
content_type Content-Type der Anfrage
content_length Länge des Anfragekörpers (Bytes)
content_md5 MD5-Prüfsumme des Anfragekörpers

Codebeispiele

Beispiel

from flask import Flask, request

app = Flask(__name__)

@app.route("/demo", methods=["GET", "POST"])
def demo():
    # Query-Parameter abrufen
    keyword = request.args.get("q", "")

    # Formulardaten abrufen
    username = request.form.get("username", "")

    # JSON-Daten abrufen
    if request.is_json:
        data = request.json
        name = data.get("name", "unknown")

    # Request-Header abrufen
    user_agent = request.headers.get("User-Agent", "")
    accept_lang = request.accept_languages.best

    # URL-Informationen abrufen
    url_info = {
        "method": request.method,       # "GET" oder "POST"
        "path": request.path,           # "/demo"
        "url": request.url,             # Vollständige URL
        "remote_addr": request.remote_addr,  # Client-IP
    }
    return url_info
Weitere Erweiterungen