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
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