Opciones de importación

Durante la importación manual y la importación programada, puede personalizar cómo se procesan los datos mediante las Opciones de importación.

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

Configuración general

Objetivo y destino

Opción	Descripción
Basic Auth	Se utiliza para importaciones desde URL que requieren autenticación con nombre de usuario/contraseña.
Rama de destino	Seleccione la rama específica en la que desea importar los datos (el valor predeterminado es `main`).
Importar en	Elija importar en una carpeta/módulo existente o crear uno nuevo.
Generar caso automáticamente	Si está habilitado, Apidog crea automáticamente un caso de prueba de "Success" si la especificación no contiene ejemplos.

Importación de entornos

Si su archivo OpenAPI/Swagger define varios servidores, habilite Importar servidores como entornos para crear automáticamente entornos coincidentes en Apidog.

Seguridad y nomenclatura

Esquemas de seguridad

Controle cómo se gestionan los securitySchemes de OpenAPI.

Autenticación global: Asigne la seguridad global de la especificación a la autenticación de la carpeta raíz en Apidog.

Autenticación no definida: Decida el comportamiento para endpoints sin seguridad específica (por ejemplo, "Heredar del padre" o "Sin autenticación").

Nomenclatura de endpoints

Si un endpoint no tiene un campo Summary descriptivo, puede elegir fuentes alternativas para el nombre:

operationId (predeterminado)

URL Path

Extracción de Description

Resolución de conflictos

Cuando los datos importados coincidan con datos existentes (según el método y la ruta), utilice estas reglas para decidir el resultado.

Conflictos de endpoints

Estrategia	Comportamiento
Sobrescribir	Reemplaza completamente el endpoint anterior con los datos nuevos.
Conservar ambos	Crea un duplicado; tanto el anterior como el nuevo existen en paralelo.
Ignorar	Omite el nuevo endpoint; conserva el anterior sin cambios.
Fusionar	Actualización inteligente: conserva cambios manuales como el nombre, las reglas de mock y las descripciones mientras actualiza la definición.
Sobrescribir seleccionados	Actualiza únicamente los campos específicos que usted seleccione, conservando los demás.

Otros recursos (esquemas/documentos)

Para documentos Markdown, esquemas y componentes, se aplican opciones similares de Sobrescribir frente a Fusionar.

Lógica de sincronización avanzada

Sincronización de carpetas

Cuando un endpoint importado coincide con un endpoint existente en el proyecto, pero sus ubicaciones de carpeta difieren:

Conservar carpeta existente: Ignora la ruta de carpeta del archivo importado. El endpoint permanece en su carpeta actual en Apidog.

Actualizar carpeta del endpoint: Mueve el endpoint a la estructura de carpetas definida en el archivo importado.

Limpieza de recursos

Decida qué ocurre con los recursos que existían en el proyecto pero que faltan en el nuevo archivo de importación.

No eliminar (seguro): Conserva los recursos huérfanos en su proyecto.

Eliminar (sincronizar): Elimina cualquier recurso que no esté presente en el nuevo archivo. Úselo con precaución para mantener un reflejo exacto de la especificación.

Opciones de importación

Configuración general#

Objetivo y destino#

Importación de entornos#

Seguridad y nomenclatura#

Esquemas de seguridad#

Nomenclatura de endpoints#

Resolución de conflictos#

Conflictos de endpoints#

Otros recursos (esquemas/documentos)#

Lógica de sincronización avanzada#

Sincronización de carpetas#

Limpieza de recursos#