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.
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.
Ejemplo: sube un avatar
Sección titulada «Ejemplo: sube un avatar»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:
name: Upload avatarkind: httpmethod: POSTurl: "{{baseUrl}}/avatars"auth: type: inheritbody: mode: formdata form: - key: name value: Ana - key: avatar type: file file: path: /Users/ana/pics/ana.png name: ana.png contentType: image/pngEnvía un archivo como campo (Multipart Form)
Sección titulada «Envía un archivo como campo (Multipart Form)»- Abre el request y haz clic en la pestaña Body.
- En el menú de arriba, elige Multipart Form, bajo Formulario.
- En la fila vacía del final, escribe la Clave, por ejemplo
name, y su Valor, por ejemploAna. - En la fila siguiente, escribe la clave
avatar. En el menú a la derecha del Valor, Tipo de campo, cambia Texto por Archivo. - La celda del valor pasa a mostrar Elegir archivo y Ningún archivo elegido. Haz clic en Elegir archivo y elige
ana.png. - La fila muestra ahora el nombre del archivo y su tamaño, y el botón dice Cambiar archivo.
- 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:
------Luvin3f9a1cContent-Disposition: form-data; name="name"
Ana------Luvin3f9a1cContent-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-Typedel archivo sale de su extensión:json,xml,txt,csv,html,pdf,zip,png,jpg,jpeg,gif,webposvg. Con otra extensión, la versión del navegador usa el tipo que informa el navegador, y la app de escritorio envíaapplication/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)»- Abre la pestaña Body y elige Archivo / binario, bajo Otro.
- Haz clic en Elegir archivo y elige el archivo.
- 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.
- Pulsa Enviar.
Para enviar el archivo con otro tipo, escribe tu propio Content-Type en Headers. Consulta Los headers que agrega Luvin.
Cópialo como cURL
Sección titulada «Cópialo como cURL»Copiar como cURL escribe el formulario con -F, y un body binario con --data-binary:
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.
App de escritorio y navegador
Sección titulada «App de escritorio y navegador»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.
Una página no puede volver a leer una ruta, así que el archivo queda en memoria mientras la app está abierta. Después de recargar la página, elígelo de nuevo.
Cuando falla
Sección titulada «Cuando falla»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. |