Cómo importar archivos HAR en Apidog (Convertir tráfico capturado en Endpoints)

Viste una aplicación realizar una solicitud en el navegador. Funciona. Los datos están ahí mismo en la pestaña Red. Ahora quieres esa misma llamada como un endpoint documentado que puedas guardar, simular y probar, sin tener que volver a escribir manualmente la URL, los encabezados y el cuerpo JSON.

Esa brecha entre "tráfico que puedo ver" y "un endpoint que puedo reutilizar" es lo que cierra un archivo HAR. Tu navegador ya registra cada solicitud y respuesta que realiza. Exporta esa grabación, entrégasela a Apidog, y cada llamada capturada se convierte en un endpoint real en tu proyecto. Esta guía recorre todo el camino: captura un HAR en las Herramientas para desarrolladores de Chrome, impórtalo con las opciones correctas y limpia los endpoints generados para que la lista siga siendo útil. Para una visión más amplia de los flujos de trabajo de captura, nuestra guía sobre herramientas de captura de paquetes con Apidog cubre el terreno adyacente.

Puedes Descargar Apidog gratis y seguir los pasos en las mismas pantallas.

Qué es un archivo HAR y por qué vale la pena conservar el tráfico capturado

HAR significa HTTP Archive. Según la documentación de Apidog, un archivo .har es "un archivo con formato JSON utilizado para registrar la interacción de un navegador web con un sitio. Registra solicitudes web, respuestas, encabezados y otros datos enviados entre el navegador y el servidor".

Léase llanamente: un archivo HAR es una transcripción completa de una sesión de navegación. Cada GET, cada POST, los encabezados de las solicitudes, los cuerpos de las respuestas, la temporización. Debido a que es JSON, se transmite bien. Puedes enviarlo por correo electrónico, adjuntarlo a un informe de errores o alimentarlo a una herramienta que sepa leerlo.

Esa última parte es por qué es importante aquí. Una sesión capturada es un registro de cómo una API se comporta realmente en la práctica, no cómo una especificación dice que debería hacerlo. Cuando conviertes ese registro en endpoints, obtienes algunas cosas de forma gratuita:

• Una forma de solicitud real. La URL exacta, los parámetros de consulta, los encabezados y el cuerpo que envió la aplicación, no una suposición.
• Una respuesta real. El código de estado y la carga útil que devolvió el servidor, que puedes usar como simulación o aserción de prueba.
• Un punto de partida para la documentación. Una API interna indocumentada se convierte en un conjunto de endpoints con nombre que puedes anotar.

Esto es útil cuando heredas un servicio sin una especificación OpenAPI, cuando estás realizando ingeniería inversa sobre cómo un widget de terceros se comunica con su backend, o cuando quieres reproducir un error con la llamada exacta que lo desencadenó.

Paso 1: Captura el HAR en las Herramientas para desarrolladores de tu navegador

La captura se realiza en tu navegador, no en Apidog. Chrome y Edge utilizan las mismas Herramientas para desarrolladores, por lo que los pasos son idénticos. Supongamos que quieres capturar el tráfico detrás de una página de historial de pedidos.

1. Abre la página que deseas grabar. Inicia sesión primero si la API necesita una sesión, ya que el HAR también contendrá esas solicitudes.
2. Abre las Herramientas para desarrolladores. Presiona F12, o Ctrl+Shift+I en Windows y Linux, o Cmd+Opt+I en Mac.
3. Cambia a la pestaña Network (Red). Aquí es donde las Herramientas para desarrolladores listan cada solicitud que realiza la página.
4. Actualiza la página, o haz clic en las acciones cuyo tráfico deseas. Cargar la vista de historial de pedidos dispara las llamadas a /api/orders, /api/orders/{id} y cualquier otra cosa que la página necesite. Cada una aparece como una fila.
5. Haz clic derecho en cualquier fila de solicitud y elige Save all as HAR with content (Guardar todo como HAR con contenido). Elige una ubicación y guarda el archivo, por ejemplo order-history.har. Si la terminología del menú te confunde, la referencia de Red de Chrome DevTools documenta el mismo flujo de captura y exportación.

Esa parte de "con contenido" es importante. Le indica a las Herramientas para desarrolladores que incluyan los cuerpos de las respuestas, no solo los metadatos de la solicitud. Sin ellos, tus endpoints importados tendrían formas de solicitud pero no respuestas de ejemplo.

Una comprobación rápida antes de salir del navegador: si abres el archivo .har en un editor de texto, es JSON legible. Verás un array entries donde cada entrada tiene un objeto request y response. Esa es la estructura que lee Apidog.

Una cosa a tener en cuenta. La carga de una página trae más que solo llamadas a la API. También busca imágenes, hojas de estilo y scripts, y cada uno de ellos termina en el HAR. No tienes que filtrarlos en el navegador; Apidog te ofrece un interruptor para descartarlos al importar, lo cual se cubre a continuación.

Paso 2: Importar el HAR a Apidog

Con el archivo guardado, ve a Apidog. El importador se encuentra en un solo lugar.

1. Abre tu proyecto y ve a Settings > Import Data > Manual (Configuración > Importar datos > Manual).
2. Selecciona HAR como formato.
3. Sube tu archivo .har, por ejemplo, el order-history.har que guardaste hace un momento.

Antes de confirmar, Apidog muestra tres opciones de importación. Estas deciden cuán limpio será el resultado, por lo que vale la pena entender cada una en lugar de simplemente hacer clic.

Opción 1: Cómo se maneja la BaseURL

Cada solicitud capturada tiene una URL completa, algo como https://api.shop.example.com/v1/orders/123. Tienes dos opciones para lo que hacer con la parte del host:

• Hardcode (Fijar) mantiene la BaseURL dentro de la ruta de cada endpoint. Cada endpoint lleva el prefijo completo https://api.shop.example.com.
• Remove (Recommended) (Eliminar (Recomendado)) elimina la BaseURL para que la ruta del endpoint se convierta en /v1/orders/123. El host se gestiona globalmente a través de variables de entorno.

Elige la opción Remove (Eliminar) a menos que tengas una razón para no hacerlo. Es la configuración recomendada por una razón: cuando la URL base reside en una variable de entorno, puedes apuntar los mismos endpoints a producción, staging o un servidor local cambiando de entorno, sin necesidad de editar los propios endpoints. El "hardcoding" bloquea cada endpoint al host desde el que capturaste, lo cual se vuelve problemático en el momento en que necesitas probar contra un servidor diferente.

Opción 2: Excluir recursos estáticos

Este es el interruptor que te salva de una lista de endpoints desordenada. La opción Static Resource (Recurso Estático), configurada en Exclude (Excluir), le indica a Apidog que omita las imágenes, CSS y archivos JavaScript capturados. Una sola carga de página puede producir docenas de estos, y ninguno de ellos son endpoints de API que quieras documentar.

Activa Exclude (Excluir) para casi todas las importaciones. Lo que queda después del filtro es el tráfico real de la API: las llamadas JSON a /api/orders y similares, no la solicitud de logo.png.

Opción 3: Generar un caso de prueba por endpoint

La tercera opción es Endpoint Case Generation (Generación de caso de endpoint). Actívala (ON) y Apidog creará un caso de prueba predeterminado para cada endpoint a medida que se importa. Un caso de prueba es una invocación guardada y ejecutable del endpoint con los valores capturados ya completados.

Este es un pequeño paso que rinde frutos más tarde. Si tu objetivo es probar estos endpoints, tener un caso listo por endpoint significa que puedes ejecutarlo inmediatamente en lugar de construirlo desde cero. Si solo quieres documentación por ahora, puedes dejarlo desactivado y añadir casos más tarde.

Confirma la importación. Apidog lee el HAR, aplica tus opciones y convierte las interacciones del navegador capturadas en endpoints de API dentro de tu proyecto. Abre el árbol de endpoints y los verás agrupados y listos.

Aquí está, aproximadamente, el aspecto de un endpoint importado una vez que se carga, usando la llamada de pedido como ejemplo:

GET /v1/orders/123
Host: api.shop.example.com
Authorization: Bearer <token-from-capture>
Accept: application/json

Y la respuesta capturada que Apidog almacena junto a ella:

{
  "id": 123,
  "status": "shipped",
  "total": 48.5,
  "currency": "USD",
  "items": [
    { "sku": "TSHIRT-BLK-M", "qty": 2, "price": 19.25 }
  ],
  "createdAt": "2026-07-14T09:31:00Z"
}

Esa respuesta son datos reales que devolvió el servidor, lo que la convierte en una base sólida para una simulación o una aserción de prueba.

Paso 3: Limpiar los endpoints generados

Una importación HAR es una primera pasada rápida, no una definición de API terminada. El tráfico capturado es desordenado por naturaleza, así que dedica unos minutos a ordenar el resultado.

Elimina el ruido. Incluso con Static Resource (Recurso Estático) configurado en Exclude (Excluir), es posible que encuentres pings de análisis, comprobaciones de estado o llamadas de terceros que no te interesan. Elimina los endpoints que no usarás para que el árbol refleje tu API real.

Renombra y agrupa. Los endpoints capturados se nombran según sus rutas, lo cual es funcional pero plano. Dales nombres claros ("Obtener pedido por ID" en lugar de /v1/orders/123) y organízalos en carpetas que coincidan con la estructura de tu API.

Corrige los parámetros de ruta. Una captura de /v1/orders/123 se importa como una ruta literal. Si 123 es realmente un ID de pedido, edita el endpoint para que ese segmento se convierta en un parámetro de ruta {orderId}. Ese único cambio convierte una llamada capturada en un endpoint reutilizable que funciona para cualquier pedido.

Limpia los secretos antes de compartir. Esto es fácil de olvidar. Tu HAR capturó cualquier token de autenticación que estuviera activo en esa sesión, y se incluyó en los encabezados. Antes de confirmar el proyecto o compartirlo con tus compañeros de equipo, mueve los tokens a variables de entorno y elimínalas de los ejemplos guardados antes de compartir el proyecto. La documentación de Stripe señala lo mismo sobre nunca permitir que las claves activas se filtren en artefactos compartidos, y un HAR es exactamente el tipo de artefacto que las filtra.

Verifica los cuerpos. Si un cuerpo está vacío donde esperabas datos, es probable que hayas exportado sin "con contenido". Vuelve a capturar usando Save all as HAR with content (Guardar todo como HAR con contenido) y reimporta.

Una vez que los endpoints están limpios, se comportan como cualquier otro endpoint en Apidog. Puedes documentarlos, generar una simulación a partir de cada respuesta y construir pruebas. La guía para escribir un escenario de prueba en Apidog continúa naturalmente desde aquí, y si quieres código cliente tipado de estos endpoints, consulta cómo generar código cliente con Apidog.

Variaciones y límites honestos

Todavía no hay un grabador automático

Podrías esperar que Apidog se ejecute en segundo plano y grabe el tráfico en vivo, como lo haría un proxy. No lo hace, y vale la pena ser directo al respecto. La documentación lo dice claramente: "Apidog actualmente no soporta la función de grabación automática de endpoints, pero hay planes para soportarla en el futuro."

Así que la ruta soportada hoy es exactamente la de esta guía: captura con las Herramientas para desarrolladores de tu navegador, exporta el HAR e impórtalo. El flujo recomendado que describe la documentación es abrir las Herramientas para desarrolladores mientras ejerces un endpoint en el navegador, exportar el HAR cuando termines, importarlo a Apidog con un clic y luego crear un escenario de prueba e importar todas las solicitudes para su reproducción. Es un paso de captura manual seguido de una importación con un clic, no un grabador en vivo. Cuando se lance la función de grabación automática, esta sección cambiará, pero no esperes por ella.

La extensión de navegador de Apidog es una herramienta diferente

Existe una extensión de navegador de Apidog, y es fácil asumir que captura tráfico HAR. No lo hace. La extensión te permite usar las funciones de prueba y depuración de API de Apidog directamente en el navegador sin abrir el cliente de escritorio. Se trata de ejecutar solicitudes, no de grabarlas.

La captura HAR proviene de las propias Herramientas para desarrolladores de tu navegador, punto. Si usas la extensión para probar, ten en cuenta que el navegador le impone límites: bloquea ciertos encabezados como Cookie, Host, Origin y Content-Length, no enviará cuerpos en solicitudes GET o HEAD, y no puede acceder a código local o a una base de datos detrás de tu máquina. Para capturar tráfico e importarlo, quédate con las Herramientas para desarrolladores y la exportación HAR. Para una depuración más exhaustiva que requiera control total de los encabezados, el Cliente de Escritorio de Apidog no tiene tales límites impuestos por el navegador.

Otros formatos se importan de la misma manera

HAR es uno de varios formatos que acepta la misma pantalla de Settings > Import Data > Manual (Configuración > Importar datos > Manual). Si ya tienes un archivo OpenAPI o Swagger, importarlo te dará un resultado más limpio que una captura, porque una especificación está estructurada a propósito. Nuestro tutorial sobre cómo migrar la documentación de APIs Swagger a Apidog cubre esa ruta, y si vienes de Postman, la guía de migración de entornos y colecciones de Postman también lo hace. Recurre a HAR cuando no exista una especificación real y el tráfico capturado sea el mejor registro que tengas.

Automatiza el flujo de trabajo con la CLI de Apidog

Importar un HAR no tiene por qué ser un paso de interfaz gráfica. La CLI de Apidog tiene un comando import que lee un archivo HAR directamente, lo cual es lo que necesitas cuando la captura ocurre en un servidor, cuando automatizas la importación en un pipeline, o cuando dejas que un agente de codificación de IA convierta una captura en endpoints:

npm install -g apidog-cli
apidog login --with-token <YOUR_ACCESS_TOKEN>

# Turn a captured HAR into endpoints in your project
apidog import --project <PROJECT_ID> --format har --file ./capture.har

La bandera --format también acepta openapi, postman, wsdl, insomnia y más, por lo que un solo comando cubre la mayoría de las fuentes de importación. Una vez que los endpoints existen y los has guardado en un escenario de prueba, ejecuta ese escenario sin interfaz gráfica en CI:

apidog run --access-token $APIDOG_ACCESS_TOKEN \
  -t <SCENARIO_ID> -e <ENV_ID> -r cli

Aquí -t es el ID del escenario de prueba guardado, -e es el ID del entorno (las mismas variables de entorno que contienen tu BaseURL), y -r selecciona el reportero, cli para la salida por consola. Construye el escenario con la guía para escribir un escenario de prueba en Apidog, luego conecta ambos comandos a tu pipeline con la guía CI/CD de la CLI de Apidog.

Preguntas frecuentes

¿Qué navegadores pueden exportar un archivo HAR?

Cualquier navegador basado en Chromium con Herramientas para desarrolladores lo hace de la misma manera, por lo que Chrome y Edge utilizan la pestaña Network (Red) y la opción del menú Save all as HAR with content (Guardar todo como HAR con contenido). La documentación de Apidog cubre específicamente la ruta de Chrome y Edge. Otros navegadores tienen sus propios menús de exportación, pero la etiqueta puede diferir, así que ajusta a la terminología de las Herramientas para desarrolladores de tu propio navegador.

Mi lista de endpoints importados es enorme. ¿Qué salió mal?

Lo más probable es que hayas dejado la opción Static Resource (Recurso Estático) configurada para incluir todo. La carga de una página trae imágenes, CSS y scripts, y todos ellos terminan en el HAR. Vuelve a importar el archivo con la opción Static Resource configurada en Exclude (Excluir), y la lista se reducirá a las llamadas de API reales. También puedes eliminar los elementos sobrantes manualmente después.

¿Debo elegir "Hardcode" o "Remove" para la BaseURL?

Elige Remove (Recommended) (Eliminar (Recomendado)) en casi todos los casos. Extrae el host de cada ruta de endpoint para que lo gestiones globalmente a través de una variable de entorno, lo que te permite alternar entre producción, staging y local sin editar los endpoints. Esa misma configuración es lo que un escenario de prueba en Apidog lee cuando se ejecuta. Elige Hardcode (Fijar) solo cuando quieras específicamente la URL completa incrustada en cada ruta.

¿El HAR incluye mis tokens de autenticación?

Sí, y esa es la trampa. Un HAR registra los encabezados reales enviados durante la sesión, por lo que cualquier token bearer o cookie que estuviera activo está en el archivo. Trata un HAR como un secreto: no lo pegues en un problema público, y después de la importación, mueve las credenciales a variables de entorno y elimínalas de los ejemplos guardados antes de compartir el proyecto.

¿Puedo omitir la interfaz gráfica e importar un HAR desde la línea de comandos?

Sí. El comando apidog import --project <id> --format har --file <path> de la CLI de Apidog introduce un HAR en tu proyecto sin abrir la aplicación, lo cual es lo que necesitas cuando la captura ocurre en un servidor o dentro de una tarea de CI. La interfaz gráfica aún te ofrece las opciones de importación interactivas (manejo de BaseURL, filtrado de recursos estáticos) para una captura única, así que elige lo que mejor se adapte: la CLI para importaciones programadas o impulsadas por agentes, la GUI cuando quieras ajustar la importación manualmente. Después de la importación, apidog run reproduce los escenarios de prueba que construyas a partir de esos endpoints.

Conclusión

Un archivo HAR es el puente entre el tráfico que puedes ver y los endpoints que puedes reutilizar. Captura la sesión en las Herramientas para desarrolladores de tu navegador con Save all as HAR with content (Guardar todo como HAR con contenido), impórtalo a través de Settings > Import Data > Manual (Configuración > Importar datos > Manual) con Remove (Eliminar) para la BaseURL y Static Resource (Recurso Estático) configurado en Exclude (Excluir), luego dedica unos minutos a renombrar, parametrizar y limpiar los secretos. Lo que obtendrás es un conjunto funcional de endpoints que puedes documentar, simular y probar.

¿Listo para convertir tu próxima captura en endpoints reales? Descarga Apidog y pruébalo gratis, no se requiere tarjeta de crédito.