Ir al contenido
↑↓ moverse↵ abriresc cerrar

Enviar requests

Envía un archivo

Sube un archivo en un request, ya sea como el body completo (Archivo / binario) o como un campo de un Multipart Form, y corrige los errores cuando Luvin no puede leerlo.

4 min de lectura

Algunas APIs reciben un archivo: un avatar, un PDF, un CSV. Luvin envía un archivo de dos maneras. Como el body completo (Archivo / binario), o como un campo entre otros (Multipart Form). Usa la primera cuando la API quiere solo el archivo, y la segunda cuando quiere el archivo más datos, como un nombre.

Una API de tienda tiene POST {{baseUrl}}/avatars. Quiere un campo de texto name y un campo de archivo avatar. El archivo del request guarda la ruta del archivo, no su contenido:

requests/uploads/upload-avatar.request.yaml
name: Upload avatar
kind: http
method: POST
url: "{{baseUrl}}/avatars"
auth:
type: inherit
body:
mode: formdata
form:
- key: name
value: Ana
- key: avatar
type: file
file:
path: /Users/ana/pics/ana.png
name: ana.png
contentType: image/png

Envía un archivo como campo (Multipart Form)

Sección titulada «Envía un archivo como campo (Multipart Form)»
  1. Abre el request y haz clic en la pestaña Body.
  2. En el menú de arriba, elige Multipart Form, bajo Formulario.
  3. En la fila vacía del final, escribe la Clave, por ejemplo name, y su Valor, por ejemplo Ana.
  4. En la fila siguiente, escribe la clave avatar. En el menú a la derecha del Valor, Tipo de campo, cambia Texto por Archivo.
  5. La celda del valor pasa a mostrar Elegir archivo y Ningún archivo elegido. Haz clic en Elegir archivo y elige ana.png.
  6. La fila muestra ahora el nombre del archivo y su tamaño, y el botón dice Cambiar archivo.
  7. Pulsa Enviar (⌘/Ctrl + Enter).

Luvin arma el body multipart y pone Content-Type: multipart/form-data con su boundary. Abre Request enviado en la respuesta para verlo. El archivo aparece como su nombre entre paréntesis angulares, porque Luvin no imprime sus bytes:

------Luvin3f9a1c
Content-Disposition: form-data; name="name"
Ana
------Luvin3f9a1c
Content-Disposition: form-data; name="avatar"; filename="ana.png"
Content-Type: image/png
<ana.png>
------Luvin3f9a1c--

Notas:

  • Un campo de Texto acepta {{variables}} y generadores. Uno de Archivo no.
  • Si cambias Archivo de nuevo a Texto, Luvin olvida el archivo elegido.
  • Una fila de Archivo sin archivo elegido no se envía. Desmarca una fila para dejarla fuera sin borrarla. La ✕ (Quitar fila) la borra.
  • El Content-Type del archivo sale de su extensión: json, xml, txt, csv, html, pdf, zip, png, jpg, jpeg, gif, webp o svg. Con otra extensión, la versión del navegador usa el tipo que informa el navegador, y la app de escritorio envía application/octet-stream.

Envía un archivo como el body completo (Archivo / binario)

Sección titulada «Envía un archivo como el body completo (Archivo / binario)»
  1. Abre la pestaña Body y elige Archivo / binario, bajo Otro.
  2. Haz clic en Elegir archivo y elige el archivo.
  3. Lee la nota: El archivo se envía tal cual. El Content-Type sale de su extensión; cámbialo en Headers si hace falta.
  4. Pulsa Enviar.

Para enviar el archivo con otro tipo, escribe tu propio Content-Type en Headers. Consulta Los headers que agrega Luvin.

Copiar como cURL escribe el formulario con -F, y un body binario con --data-binary:

Ventana de terminal
curl -X POST 'https://api.shop.test/avatars' \
-F 'name=Ana' \
-F 'avatar=@/Users/ana/pics/ana.png'

En la versión del navegador no se conoce la ruta, así que el comando usa el nombre del archivo: avatar=@ana.png. Consulta Importar y copiar cURL.

Luvin guarda la ruta del archivo y lo lee cada vez que envías. Si editas el archivo, el siguiente Enviar usa el contenido nuevo.

  • Un archivo de más de 50 MB no se envía.
  • Luvin solo lee archivos que elegiste con Elegir archivo, o que están dentro de un workspace abierto.

El área de la respuesta dice el motivo, y no se envía nada.

Mensaje Qué hacer
Vuelve a elegir «ana.png» Luvin no puede leer el archivo. En el navegador, pasa después de recargar. En la app de escritorio, pasa cuando el request vino de otro computador o de un compañero: la ruta nunca se eligió aquí. Haz clic en Elegir archivo y elígelo.
«ana.png» ya no está en esa ubicación El archivo se movió o se borró. Haz clic en Cambiar archivo y elígelo.
«ana.png» pesa más de 50 MB Usa un archivo más pequeño.