Opções de Importação

Durante a importação manual e a importação agendada, pode personalizar a forma como os dados são processados utilizando as Opções de Importação.

Definições Gerais

Destino e Localização

Opção	Descrição
Basic Auth	Utilizado para importações por URL que exigem autenticação com nome de utilizador/palavra-passe.
Ramo de Destino	Selecione o ramo específico para o qual pretende importar os dados (a predefinição é `main`).
Importar Para	Escolha importar para uma pasta/módulo existente ou criar um novo.
Gerar Caso Automaticamente	Se estiver ativado, o Apidog cria automaticamente um caso de teste de "Sucesso" se a especificação não tiver exemplos.

Importação de Ambientes

Se o seu ficheiro OpenAPI/Swagger definir vários servidores, ative Importar Servidores como Ambientes para criar automaticamente ambientes correspondentes no Apidog.

Segurança e Nomenclatura

Esquemas de Segurança

Controle como os securitySchemes do OpenAPI são tratados.

Autenticação Global: Mapeie a segurança global da especificação para a autenticação da pasta Raiz no Apidog.

Autenticação Indefinida: Decida o comportamento para endpoints sem segurança específica (por exemplo, "Herdar do elemento principal" ou "Sem autenticação").

Nomenclatura de Endpoints

Se um endpoint não tiver um campo Summary descritivo, pode escolher uma fonte alternativa para o nome:

operationId (Predefinição)

URL Path

Extração de Description

Resolução de Conflitos

Quando os dados importados correspondem a dados existentes (com base no Método e Caminho), utilize estas regras para decidir o resultado.

Conflitos de Endpoints

Estratégia	Comportamento
Substituir	Substitui completamente o endpoint antigo pelos novos dados.
Manter Ambos	Cria um duplicado; tanto o antigo como o novo existem lado a lado.
Ignorar	Ignora o novo endpoint; mantém o antigo inalterado.
Intercalar	Atualização inteligente: mantém alterações manuais como Nome, regras de Mock e Descrições, enquanto atualiza a definição.
Substituir Selecionados	Atualiza apenas os campos específicos que selecionar, preservando os restantes.

Outros Recursos (Esquemas / Documentos)

Para documentos Markdown, Esquemas e Componentes, aplicam-se opções semelhantes de Substituir vs Intercalar.

Lógica de Sincronização Avançada

Sincronização de Pastas

Quando um endpoint importado corresponde a um endpoint existente no projeto, mas as respetivas localizações de pasta diferem:

Manter pasta existente: Ignora o caminho da pasta no ficheiro importado. O endpoint permanece na sua pasta atual no Apidog.

Atualizar pasta do endpoint: Move o endpoint para a estrutura de pastas definida no ficheiro importado.

Limpeza de Recursos

Decida o que acontece aos recursos que existiam no projeto, mas que estão em falta no novo ficheiro de importação.

Não eliminar (Seguro): Mantém os recursos órfãos no seu projeto.

Eliminar (Sincronizar): Remove qualquer recurso que não esteja presente no novo ficheiro. Utilize com cuidado para manter um espelho exato da especificação.

Opções de Importação

Definições Gerais#

Destino e Localização#

Importação de Ambientes#

Segurança e Nomenclatura#

Esquemas de Segurança#

Nomenclatura de Endpoints#

Resolução de Conflitos#

Conflitos de Endpoints#

Outros Recursos (Esquemas / Documentos)#

Lógica de Sincronização Avançada#

Sincronização de Pastas#

Limpeza de Recursos#