Trabalhando com múltiplas versões

Última atualização: 13/10/2026

Os Contratos de API permitem que você mantenha várias versões do mesmo contrato de API para que você possa manter uma versão publicada estável enquanto prepara alterações em uma nova versão.

Manter uma versão de API existente em produção enquanto introduz quebras em uma nova versão.
Acompanhe e gerencie versões publicadas a partir de uma única localização.
Trabalhe em alterações da API sem afetar as versões existentes.

Quando você cria uma nova versão, todo o conteúdo é copiado para a nova versão. A versão mais recente pode, então, ser atualizada de forma independente sem afetar as versões anteriores.

Apenas a versão mais recente é editável, e você só pode criar uma nova versão a partir dela. Versões mais antigas são somente leitura.

A página inicial do API Contracts exibe todas as APIs de sua propriedade e todas as versões de API compartilhadas com você.

Criando uma nova versão de API

Crie uma nova versão de uma definição de API existente.

Observação:

Você só pode criar uma nova versão a partir da versão mais recente. Versões mais antigas são somente leitura e não podem ser editadas ou usadas para criar uma nova versão.

Você é proprietário da API ou editor de pelo menos uma versão da API.

Na página inicial, vá para a API para a qual você deseja criar uma nova versão.
Você pode filtrar a lista por nome ou proprietário, se necessário.
Abra a versão mais recente para ver a Pré-visualização e, em seguida, clique em Criar uma nova versão.
Insira a nova versão.
Clique em Criar.

Uma nova versão da sua API é criada com o mesmo conteúdo da versão mais recente. A simulação e a documentação estão desabilitadas por padrão.

Publicando uma versão de API no Qlik Catalog

Publique uma versão de um contrato de API em um espaço do Qlik para que os colaboradores possam encontrá-lo no Qlik Catalog.

Você é o proprietário da API ou editor da versão da API.

Quando você publica uma versão, a versão do contrato se torna imutável e somente leitura em Contratos de API. Para fazer alterações, crie uma nova versão a partir da versão mais recente e continue trabalhando na nova versão.

Na página inicial, clique na versão que você deseja publicar para abrir a Pré-visualização e, em seguida, clique em Publicar.
Na caixa de diálogo de publicação, selecione o espaço do Qlik onde você deseja que a versão seja publicada.
Revise a pré-visualização da versão e insira uma nota de publicação.
Clique em Publicar.

A versão selecionada é publicada no espaço do Qlik escolhido e se torna somente leitura em Contratos de API. Se precisar editar o contrato novamente, crie uma nova versão primeiro.

Excluindo uma versão da API

Você é o proprietário da API.

Na página inicial, clique no botão ao lado da versão que deseja excluir e clique em Excluir.
Clique em Excluir para confirmar.

A versão selecionada é excluída. Se você quiser excluir uma API inteira, precisará excluir cada versão.

Importando conteúdo da versão

Importe o conteúdo de um contrato existente para uma versão da API, substituindo ou mesclando seu conteúdo atual.

Você é o proprietário da API ou editor da versão da API.

Use esse recurso para atualizar uma versão de um arquivo de contrato externo sem criar uma nova versão. O identificador da versão é preservado durante toda a importação.

Isso é diferente de importar uma definição, que cria uma nova API no API Contracts.

Abra Importar conteúdo da versão para a versão que deseja atualizar.
Esta ação não está disponível para uma versão somente leitura.

Você pode acessar esta ação nos seguintes locais:
- Na página inicial, clique em ao lado da versão e clique em Importar conteúdo da versão.
- Na Pré-visualização da versão, clique em > Importar conteúdo da versão.
- No editor de versões, clique em Editar > Importar conteúdo da versão.
Selecione um formato e uma origem para o contrato a ser importado.
Você pode importar de um arquivo local, de uma URL ou de texto que você cola diretamente na caixa de diálogo.
Em Comportamento, selecione como aplicar o conteúdo importado.
- Substituir: substitui todo o conteúdo atual pelo contrato importado. O nome da API, o identificador de versão e a versão da especificação são preservados.
- Mesclar: combina o conteúdo importado com o conteúdo da versão existente. O nome da API e o identificador da versão são preservados. Se um elemento importado tiver o mesmo nome que um elemento existente, o elemento importado será renomeado com o sufixo _merge (por exemplo, User_merge). URLs base e tipos de mídia duplicados são ignorados.
Clique em Importar.

O editor de versões é aberto com o conteúdo atualizado aplicado.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo – um erro de digitação, uma etapa ausente ou um erro técnico – avise-nos!

Deixe seu feedback aqui