API del objeto Request de Flask

La clase Request encapsula toda la información de la solicitud HTTP enviada por el cliente.

Mediantefrom flask import requestimportar el objeto proxy y usarlo directamente en las funciones de vista.


Referencia rápida de propiedades comunes

Propiedad Tipo Descripción Valor de ejemplo
method str Método de la solicitud HTTP "GET"、"POST"
path str Parte de la ruta de la URL (sin dominio ni cadena de consulta) "/search"
full_path str Ruta + cadena de consulta "/search?q=ejemplo"
url str URL completa de la solicitud (sin cadena de consulta) "http://localhost:5000/search"
base_url str Igual que url, sin la cadena de consulta al final "http://localhost:5000/search"
url_root str Dominio + ruta raíz de la aplicación "http://localhost:5000/"
host str Encabezado Host, con puerto "localhost:5000"
host_url str scheme + host + raíz de la aplicación "http://localhost:5000/"
scheme str Protocolo "http"、"https"
remote_addr str Dirección IP del cliente "127.0.0.1"
endpoint str Endpoint de la ruta coincidente "index"、"blog.show"
url_rule Rule Objeto de regla de ruta coincidente Instancia de Werkzeug Rule
view_args dict Variables dinámicas en la URL {"post_id": 42}
blueprint str Nombre del blueprint actual "auth"、"blog"
blueprints list Lista de niveles de blueprints coincidentes actualmente ["auth"]
is_json bool Si el Content-Type de la solicitud es JSON True / False

Obtener datos de la solicitud

Propiedad/Método Tipo Descripción
args MultiDict Parámetros de consulta de la URL. Acceder a /search?q=flask → request.args.get("q")
form MultiDict Datos de formulario POST (application/x-www-form-urlencoded o multipart/form-data)
json dict / None Cuerpo de solicitud JSON (analizado como objeto de Python). Devuelve None si la solicitud no es JSON.
data bytes Datos brutos del cuerpo de la solicitud
files FileMultiDict Archivos subidos. request.files["file"] devuelve un objeto FileStorage
cookies dict Cookies enviadas por el cliente
headers Headers Encabezados de la solicitud. Soporta múltiples formas de acceso
get_json(force=False, silent=False, cache=True) — Analiza el cuerpo de solicitud JSON. force fuerza el análisis de tipos no JSON, silent devuelve None en caso de error.

Sobreargs、formTipos como MultiDict, utilice siempre.get(key, default)método para obtener valores. Úselo directamente.request.args["key"]Acceder a una clave inexistente lanzará KeyError (devuelve un error 400).


Propiedades de negociación de contenido

Propiedad/Método Descripción
accept_mimetypes Lista de tipos MIME aceptados por el cliente (objeto MIMEAccept)
accept_charsets Conjunto de caracteres aceptado por el cliente
accept_encodings Codificación aceptada por el cliente
accept_languages Idiomas aceptados por el cliente
content_type Content-Type de la solicitud
content_length Longitud del cuerpo de la solicitud (bytes)
content_md5 Valor de comprobación MD5 del cuerpo de la solicitud

Ejemplo de código

Ejemplo

from flask import Flask, request

app = Flask(__name__)

@app.route("/demo", methods=["GET", "POST"])
def demo():
    # Obtener parámetros de consulta
    keyword = request.args.get("q", "")

    # Obtener datos de formulario
    username = request.form.get("username", "")

    # Obtener datos JSON
    if request.is_json:
        data = request.json
        name = data.get("name", "unknown")

    # Obtener encabezados de solicitud
    user_agent = request.headers.get("User-Agent", "")
    accept_lang = request.accept_languages.best

    # Obtener información de la URL
    url_info = {
        "method": request.method,       # "GET" o "POST"
        "path": request.path,           # "/demo"
        "url": request.url,             # URL completa
        "remote_addr": request.remote_addr,  # IP del cliente
    }
    return url_info
Otras extensiones