Exportar datos

Apidog admite la exportación de APIs a varios formatos estándar, incluidos OpenAPI Specification, HTML, Markdown, Apidog y Postman, para adaptarse a distintas necesidades de integración y documentación.

Cómo exportar

Vaya a la configuración de exportación

Vaya a Settings -> Export Data en la barra lateral izquierda.

CleanShot 2025-11-24 a las 15.57.14@2x.png

Seleccione el alcance de los datos

Elija exportar todas las APIs o seleccione Endpoints/Tags específicos.

Elija el formato y configure

Seleccione el formato deseado (por ejemplo, OpenAPI 3.0) y ajuste cualquier configuración específica del formato.

Formatos compatibles

Formato	Versiones / Notas
OpenAPI / Swagger	Admite `3.1`, `3.0` y `2.0`. Exporte como `JSON` o `YAML`. Incluye compatibilidad con campos de extensión de Apidog.
HTML / Markdown	Genera documentación estática. Es ideal para compartir sin conexión.
Apidog	Formato nativo que contiene todos los datos del proyecto.
Postman	Exporta colecciones compatibles con Postman.

Para la documentación sin conexión, puede hacer clic en "Open URL" para ver los datos sin procesar directamente en su navegador.

Opciones avanzadas de exportación

1. Exportar desde ramas de sprint

Para exportar datos desde una rama de sprint específica:

Cambie a la rama deseada mediante el selector de ramas en la esquina superior izquierda.

Vaya a Export Data. Apidog exportará todos los datos de la rama actual.

Nota: Este proceso fusiona la rama de sprint con la rama principal en memoria para garantizar la integridad de los datos (resolviendo referencias). No puede seleccionar un subconjunto de endpoints al exportar desde una rama de sprint.

2. Configuración personalizada de OpenAPI

Para exportaciones avanzadas de OpenAPI, puede configurar reglas de inclusión mediante Module Name > Overview > Export/Backup API Specification > Add.

Puede optar por incluir el campo OperationId en la exportación, lo cual es útil para generar clientes de código. Obtenga más información sobre OperationId.

Preguntas frecuentes

P: ¿Por qué faltan algunas APIs en mi exportación?
R: Esto suele ocurrir si varias APIs comparten exactamente el mismo método y ruta. La especificación OpenAPI requiere combinaciones únicas de método+ruta. Apidog aplica esta regla durante la exportación (especialmente para los formatos HTML/Markdown/OpenAPI). Haga que sus endpoints sean únicos para resolverlo. Obtenga más información sobre la identificación de endpoints.

P: ¿Por qué el orden de las APIs es diferente en las exportaciones de Markdown/HTML?
R: La especificación Swagger/OpenAPI subyacente normalmente no impone un orden estricto. Las exportaciones de Markdown y HTML se generan en función de estos datos de especificación, lo que puede dar lugar a un orden de clasificación diferente del que ve en el cliente de Apidog.

P: ¿Puedo exportar a PDF o Word?
R: La exportación directa no es compatible. Le recomendamos exportar primero a Markdown y, a continuación, utilizar una herramienta como Typora o Pandoc para convertir el archivo Markdown a PDF, Word u otros formatos.

P: ¿Se exportan los valores de autenticación?
R: Sí. Apidog exporta automáticamente las configuraciones de Auth a la sección securitySchemes del archivo OpenAPI/Swagger. No se requiere ningún paso manual.

Cómo exportar#

Formatos compatibles#

Opciones avanzadas de exportación#

1. Exportar desde ramas de sprint#

2. Configuración personalizada de OpenAPI#

Preguntas frecuentes#

Cómo exportar

Formatos compatibles

Opciones avanzadas de exportación

1. Exportar desde ramas de sprint

2. Configuración personalizada de OpenAPI

Preguntas frecuentes