Aceptar subidas de imágenes en un Formulario de pago
Una pregunta de Archivo acepta JPEG, PNG, WebP y GIF en un Plan de pago y se comprueba aunque el modo Estricto esté apagado. Declárala, acota el número de archivos con la configuración del Formulario y explica el almacenamiento privado y los enlaces firmados.
Esta publicación se tradujo automáticamente. Lee el original en inglés
Una pregunta de tipo Archivo es la única parte de un Formulario que acepta bytes en lugar de texto. En un Plan de pago acepta imágenes raster: JPEG, PNG, WebP y GIF. Este tutorial declara ese campo, lo acota y explica qué pasa con el archivo cuando la persona que rellena el Formulario pulsa Enviar. Se mantiene dentro del límite de las imágenes de principio a fin, porque ese límite es lo que documenta la función.
Qué acepta una pregunta de Archivo
La lista de formatos es una lista de permitidos, no una pista. Sin ningún formato indicado, una pregunta de Archivo acepta las cuatro imágenes raster anteriores. SVG está ausente a propósito: un SVG es un script que se muestra como una imagen, y devolverlo a una bandeja de entrada convertiría un Formulario en un alojador de scripts. Tampoco es un campo para soltar archivos comprimidos: ni ZIP ni paquetes. Un Formulario sin pregunta de Archivo rechaza de plano las subidas multiparte, así que el campo es también el interruptor que activa las subidas.
JPEG — fotografías y salida de la cámara del móvil.
PNG — capturas de pantalla e imágenes con transparencia.
WebP — la misma imagen con menos bytes.
GIF — bucles cortos y gráficos sencillos.
Declara el campo y luego acótalo
Añade la pregunta, elige Archivo como tipo y deja los formatos aceptados en las cuatro imágenes. Después fija cuántos archivos admitirá la pregunta. El ajuste pertenece a la pregunta, así que un mismo Formulario puede pedir una sola foto de perfil y, más abajo, varias capturas.
Ajuste | Qué elegir | Por qué importa |
|---|---|---|
Tipo | Archivo | Declara el campo, y eso lo hace autoritativo en la recepción. |
Formatos aceptados | JPEG, PNG, WebP, GIF | Lo que queda fuera de la lista se rechaza, no se convierte. |
Archivos máximos | Lo fija el Formulario | El número de archivos está acotado por la configuración del Formulario. |
Obligatorio | Activado o desactivado | Obligatorio convierte una subida vacía en un rechazo. |
Autoritativo aunque el modo Estricto esté desactivado
El modo Estricto es una decisión de cada Formulario. Si lo dejas apagado, el esquema aconseja; si lo enciendes, el esquema decide. Una pregunta de Archivo no espera esa decisión. Una pregunta de Archivo declarada se comprueba en cada Envío —tamaño, tipo y contenido— y rechaza en lugar de recortar. Es deliberado: un archivo es la única respuesta que cuesta almacenamiento y puede llevar código.
Así que un archivo equivocado se rechaza incluso en un Formulario relajado. Se avisa a quien lo envía y el intento se guarda como un Envío rechazado que puedes revisar. Cualquier otro campo de ese Formulario puede seguir siendo consultivo; el archivo no.
Adónde va el archivo y quién puede abrirlo
Un archivo subido forma parte del contenido del Envío, no es un recurso público. Se guarda de forma privada y se lee mediante un enlace firmado que caduca. No hay una dirección pública que adivinar, y un enlace copiado no es una puerta permanente a las fotos de nadie.
Compruébalo una vez con un archivo real
Envía el Formulario una vez con un JPEG hecho con el móvil, otra con una captura PNG y otra con algo fuera de la lista. Las dos primeras deberían llegar con el Envío; la tercera debería rechazarse con un motivo. Esa pasada de cinco minutos detecta los errores habituales: un campo que nadie marcó como Obligatorio, un recuento que se quedó en uno cuando la página pide tres fotos, o una etiqueta que promete un formato que el campo no acepta.
Después abre una imagen guardada desde el Envío. Si el enlace firmado funciona con la sesión iniciada y el mismo archivo no es accesible en una dirección pública normal, el almacenamiento se comporta como está documentado.
Qué contarle a la persona que rellena el Formulario
Etiqueta la pregunta con el formato y el número, no solo con la palabra Subir: «Hasta tres fotos (JPEG, PNG, WebP o GIF)». Quien rellena lee la etiqueta antes de elegir un archivo, y una pista correcta es mejor que un rechazo después.
Di también qué pasa con el archivo. Quien entrega una fotografía tiene derecho a saber que se guarda de forma privada y se abre mediante un enlace, no se publica en una página.
La forma de la petición de un Envío multiparte, incluida la parte del archivo, está en la referencia de la API. Las subidas llegaron con la primera Versión: v1.0.0 en el Registro de cambios las enumera junto a las exportaciones y los resúmenes de respuestas.