En el ámbito de las pruebas y el desarrollo de API, lidiar con la carga de archivos es una tarea fundamental. Postman, una herramienta de prueba de API fácil de usar, ofrece funciones para cargar y enviar archivos. Pero, ¿cuál es el mejor enfoque para cargar archivos sin problemas en Postman? Profundizaremos en este tema en el siguiente blog.
¿Qué es Postman?
Postman es una potente herramienta de desarrollo de API que se ha convertido en un estándar de la industria para desarrolladores y testers que trabajan con API. Proporciona una interfaz gráfica fácil de usar para crear, enviar y administrar solicitudes HTTP/HTTPS, así como para inspeccionar y analizar las respuestas recibidas de los servicios web.

Con Postman, los desarrolladores pueden probar fácilmente sus API durante el proceso de desarrollo, depurar problemas y colaborar con los miembros del equipo compartiendo colecciones de solicitudes y entornos.
Tipos de archivos de carga compatibles con Postman para el equipo
Postman admite la carga de archivos de diferentes maneras, según los requisitos de la API con la que estés interactuando. Aquí te mostramos cómo puedes cargar archivos en Postman para diferentes escenarios:
Cargar archivo en Postman en Raw
Raw es un tipo de datos que se utiliza para enviar datos sin procesar en el cuerpo de la solicitud HTTP. Cuando se utiliza el parámetro RAW, un usuario puede especificar directamente los datos que se van a enviar en el cuerpo de la solicitud sin utilizar una codificación o formato específico. Este método es más flexible y se puede utilizar para enviar varios tipos de datos, incluyendo texto plano, JSON, XML, etc.
Si la API espera que el archivo se envíe como datos sin procesar en el cuerpo de la solicitud, puedes utilizar la pestaña "Body" en Postman, seleccionar la opción "raw" y, a continuación, elegir el tipo de contenido adecuado (por ejemplo, application/octet-stream
para archivos binarios, text/plain
para archivos de texto). A continuación, puedes pegar el contenido del archivo directamente en el cuerpo de la solicitud o buscar y seleccionar el archivo desde tu sistema de archivos local.
Cargar archivo en Postman con cuerpo JSON
Si la API espera que el archivo se envíe como una cadena codificada en base64 en el cuerpo de la solicitud, puedes utilizar el tipo de contenido application/json
e incluir el contenido del archivo codificado como parte de la carga útil JSON.

Cargar archivo en Postman GraphQL
Si tu API GraphQL acepta cargas de archivos, puedes utilizar GraphQL
, entonces se buscarán los datos automáticamente.

Cargar archivo en Postman con multipart/form-data
Cuando la API espera que el archivo se envíe como una solicitud multipart/form-data, puedes utilizar la pestaña "Body" en Postman, seleccionar la opción "form-data" y, a continuación, añadir un nuevo par clave-valor donde la clave representa el nombre del parámetro para el archivo, y el valor es el archivo que deseas cargar.

Cargar archivo en Postman en x-www-form-urlencodeed
Esta codificación se utiliza normalmente para enviar datos de formulario, pero también se puede utilizar para la carga de archivos en ciertos casos. En Postman, puedes utilizar la pestaña "Body", seleccionar la opción "x-www-form-urlencoded" y, a continuación, añadir un nuevo par clave-valor donde la clave representa el nombre del parámetro para el archivo, y el valor es la ruta del archivo o el contenido del archivo codificado utilizando el método apropiado (por ejemplo, @/path/to/file.ext
o @/C:/path/to/file.ext
para las rutas de archivo, o el contenido codificado en base64 para el archivo).
Ahora, es posible que ya conozcas los diferentes tipos de archivos de carga de Postman, tomaremos un ejemplo de archivos de datos de formulario para guiarte sobre cómo cargar archivos en Postman.
Cómo cargar archivos con datos de formulario de Postman
Al probar API, es común necesitar cargar archivos como parte de la solicitud. Postman carga archivos este proceso es fácil con su función integrada de carga de archivos. Esta función es esencial para escenarios en los que las aplicaciones necesitan procesar y manejar imágenes, documentos o varios tipos de archivos cargados por el usuario.
Paso 1. Selecciona la solicitud POST en Postman
Para cargar un archivo en Postman, comienza creando una nueva solicitud o abriendo una API existente. Aquí hay una solicitud POST como ejemplo.
Paso 2. Elige el archivo "form-data"
Selecciona la pestaña "Body" y elige "form-data" como el tipo de cuerpo. Además, Postman también proporciona la carga de cuerpos de solicitud binarios.

Paso 3. Haz clic en "Files" para establecer el tipo de valor
Selecciona el archivo o texto que deseas cargar. También puedes especificar una clave para el archivo, que se utilizará en la solicitud API. Aquí establecemos el "File" para cargar.

Paso 4. Carga un archivo en Postman
Una vez que hayas cargado tu archivo en Postman y hayas establecido la clave, puedes enviar la solicitud como de costumbre. El archivo se incluirá en la solicitud y haz clic en "Send" archivo en datos de formulario en Postman.

Aquí está la guía definitiva para ayudarte a cargar archivos de Postman y cuerpo JSON.

Por qué la carga de archivos de Postman no funciona
Algunos de los desarrolladores que usaron Postman se enfrentan a problemas relacionados con el directorio de trabajo de Postman y la capacidad de acceder a archivos locales al enviar solicitudes con cargas de archivos o cargas útiles de datos de formulario. Estos son algunos casos comunes de "Por qué la carga de archivos de Postman no funciona":
- Advertencia del directorio de trabajo: La advertencia que recibiste "Este archivo no está en tu directorio de trabajo..." sugiere que Postman no puede acceder al archivo local que estás intentando cargar desde su configuración actual de directorio de trabajo. Esto puede causar problemas al compartir solicitudes con compañeros de equipo o al colaborar.
- Cambiar el nombre de la carpeta del agente de Postman: La sugerencia de cambiar el nombre de la carpeta
Postman Agent
aPostman
enC:/Users/<username>
probablemente esté relacionada con un problema anterior con la configuración del directorio de trabajo de Postman en Windows. Esto puede o no resolver el problema actual dependiendo de tu versión de Postman. - No se puede seleccionar el archivo en Form-Data: El error "No se puede seleccionar el archivo en form-data, "Asegúrate de que Postman pueda leer archivos dentro del directorio de trabajo." indica directamente que Postman no puede acceder al archivo local que estás intentando cargar debido a los permisos o la configuración del directorio de trabajo.
- Error de cuerpo de solicitud vacío: El error
{"error": {"code": "InvalidRequest", ...}}
sugiere que el servidor está recibiendo un cuerpo de solicitud vacío cuando intentas cargar el archivo, lo que probablemente esté relacionado con el problema del directorio de trabajo que impide que Postman acceda y envíe el archivo correctamente. - Clave de documentación de la API: La documentación de la API debe proporcionar orientación sobre la clave específica o el nombre del parámetro requerido para las cargas de archivos o las cargas útiles de datos de formulario. Sin la clave correcta, el servidor puede interpretar la solicitud como no válida o que faltan datos requeridos.
- Problemas de tipo de contenido: Los errores relacionados con los encabezados
Content-Type
no admitidos (application/json
omultipart/form-data
) indican una falta de coincidencia entre el formato de datos esperado por el servidor y lo que Postman está enviando. Esto podría deberse a una configuración incorrecta o a que la API espera un formato diferente por completo.
Para resolver este problema, debes intentar los siguientes pasos:
- Verifica y actualiza el directorio de trabajo de Postman: En Postman, ve a
Settings
>Working Directories
y asegúrate de que el directorio de trabajo esté configurado en una ubicación donde Postman tenga permisos de lectura/escritura para acceder a los archivos locales. - Verifica la documentación de la API: Revisa cuidadosamente la documentación de la API para conocer el nombre del parámetro correcto, el tipo de contenido y cualquier otro requisito específico para las cargas de archivos o las cargas útiles de datos de formulario.
- Prueba con archivos de muestra: Intenta probar el proceso de carga de archivos primero con un archivo de texto simple o un archivo pequeño, para eliminar cualquier problema relacionado con el archivo específico que estás intentando cargar.
- Verifica la configuración de Postman y la configuración del proxy: Asegúrate de que la configuración de Postman y cualquier configuración de proxy no estén interfiriendo con las cargas de archivos o las solicitudes de datos de formulario.
- Actualiza Postman a la última versión: Si el problema persiste, considera actualizar Postman a la última versión disponible, ya que las versiones más nuevas pueden haber resuelto cualquier problema conocido o proporcionado una mejor compatibilidad con las cargas de archivos.
Sin embargo, en el panorama en constante evolución de la carga de archivos, existen soluciones alternativas que pueden mejorar significativamente tu experiencia de prueba de API.
Presentamos Apidog, un sólido kit de herramientas de API con una interfaz fácil de usar y compatibilidad con varios formatos de archivo. Exploremos cómo Apidog simplifica el proceso de carga de archivos para fines de prueba.
Apidog: La mejor alternativa a Postman
Apidog es un potente kit de herramientas alternativo a Postman que cuenta con una interfaz fácil de usar y admite la carga de múltiples formatos de archivo. La capacidad de carga de archivos de Apidog está diseñada para hacer que las pruebas de API sean más eficientes y efectivas, permitiendo a los desarrolladores y testers incorporar sin problemas la funcionalidad de carga de archivos en sus flujos de trabajo de prueba de API.

En Apidog, puedes cargar fácilmente archivos para probar creando una nueva solicitud y navegando a la pestaña "Body". Desde allí, puedes seleccionar varios parámetros, como form-data, binario, JSON, etc. Puedes cambiar fácilmente de Postman a Apidog como principiante.
¿Cómo cargar archivos rápidamente en Apidog?
Ahora, presentaremos la guía sobre cómo cargar un archivo en Apidog rápidamente. Primero, puedes comenzar en Apidog web o descarga gratuita para iniciar sesión a través de Google o Github.
- Para abrir la API, cambia a la página Edit. Si eres un nuevo usuario, puedes crear rápidamente una nueva solicitud haciendo clic en el icono "+" en la barra lateral izquierda.
- A continuación, en el "Body", puedes seleccionar el tipo de medio o el tipo de datos que deseas cargar. Selecciona "raw" e introduce texto o texto plano a continuación.

Opcional: Apidog también admite la carga de aplicaciones y octet-stream. Puedes hacer clic en el botón "Upload" para elegir qué archivo deseas cargar en Apidog.

3. Selecciona el documento de texto que se va a cargar, que admite el formato Markdown. Cuando termines, haz clic en el botón Save.

4. Envía la solicitud y la verificación del esquema de respuesta se ha superado.

Apiodg destaca como un generador de documentación de API debido a su ejemplar facilidad de uso, combinada con una amplia gama de ofertas de funciones. Además, la curva de aprendizaje para usar esta herramienta es notablemente baja, lo que la hace accesible a usuarios de todos los niveles de experiencia y competencia técnica.
Conclusión
Estos son los pasos detallados para cargar archivos en Postman, sigue los pasos y podrás dominarlos. Apidog no solo es fácil de usar y visualizar, sino que también tiene la capacidad de diseñar, administrar y simular documentos, además de las funciones de prueba compatibles con Postman, y la capacidad de importar API en formato Postman con un solo clic para una conversión perfecta a Apidog.