Apidog

Plataforma de desarrollo de API colaborativa todo en uno

Diseño de API

Documentación de API

Depuración de API

Simulación de API

Prueba automatizada de API

Cómo subir un archivo en Postman

Postman ayuda a probar APIs con subida de archivos o JSON complejos. Exploraremos cómo subir archivos en Postman y alternativas. ¡Empecemos!

Daniel Costa

Daniel Costa

Updated on April 15, 2025

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.

Postman

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.

💡
Sin embargo, es importante reconocer que Postman tiene sus limitaciones, particularmente cuando se trata de ejecutores de colecciones de API. Si estás buscando una alternativa más versátil, sigue leyendo, ya que también te presentaremos Apidog, que destaca como la solución óptima para tus requisitos de carga de archivos.
button

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.

Post request

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.

postman upload file

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.

Apidog file

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

  1. 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.
  2. Cambiar el nombre de la carpeta del agente de Postman: La sugerencia de cambiar el nombre de la carpeta Postman Agent a Postman en C:/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.
  3. 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.
  4. 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.
  5. 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.
  6. Problemas de tipo de contenido: Los errores relacionados con los encabezados Content-Type no admitidos (application/json o multipart/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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Apidog

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.

button
  1. 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.
  2. 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.
RAW
💡
Nota: Cuando el tipo de parámetro Body está establecido en raw, el Content-Type se puede establecer manualmente sin ninguna restricció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.

Binary
💡
Nota: Binario se refiere a datos binarios. Al cargar archivos o imágenes como datos binarios, puedes pasar estos datos como el parámetro Body en la solicitud al servidor. Por lo general, el tipo de estos datos también se especifica en el encabezado de la solicitud.

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.

Send API

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

Verify

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.

button
Cómo usar Lovable AI (Alternativa a Cursor para desarrolladores web)Tutoriales

Cómo usar Lovable AI (Alternativa a Cursor para desarrolladores web)

Aprende a crear cualquier web con Lovable en esta guía completa. Descubre procesos paso a paso, funciones innovadoras e integra herramientas gratuitas como Apidog para gestión API.

Daniel Costa

April 15, 2025

Cómo usar n8n con servidores MCPTutoriales

Cómo usar n8n con servidores MCP

Automatiza flujos con n8n y servidores MCP para IA. Guía técnica: configuración, APIs, nodo "MCP Server Trigger" y Apidog para pruebas.

Daniel Costa

April 14, 2025

Cómo añadir claves API personalizadas a Cursor: Una guía completaTutoriales

Cómo añadir claves API personalizadas a Cursor: Una guía completa

Este tutorial te guiará para configurar y gestionar claves API personalizadas en Cursor (OpenAI, Anthropic, Google y Azure).

Daniel Costa

April 11, 2025