Importação de APIs

Cenário

O APIG permite importar APIs do Swagger 2.0 para grupos de APIs existentes ou novos. Swagger é uma ferramenta de código aberto construída com base nas especificações OpenAPI para projetar, construir, gravar e usar APIs REST.

Você pode importar APIs individualmente ou em lotes, dependendo do número de APIs contidas em um arquivo Swagger.

Pré-requisitos

• O arquivo API Swagger a ser importado está disponível e já tem definições de API estendidas suplementadas. Para obter mais informações, consulte Definição estendida.
• Você tem cotas suficientes de grupos de APIs e APIs.

Procedimento

1. Acesse o console de gerenciamento.
2. Clique em no canto superior esquerdo e selecione uma região.
3. Clique em no canto superior esquerdo e escolha API Gateway.
4. Escolha um tipo de gateway no painel de navegação.
   • Shared Gateway: você pode criar e gerenciar APIs imediatamente. Você será cobrado com base no número de chamadas de API.
   • Dedicated Gateways: você pode criar e gerenciar APIs depois de comprar um gateway. Você será cobrado com base na duração de uso do gateway.

5. No painel de navegação, escolha API Publishing > APIs.
6. Clique em Import API.
7. Defina os parâmetros listados em Tabela 1.
   Figura 1 Importação de APIs
   

   Tabela 1 Parâmetros para importar APIs

   Parâmetro	Descrição
   Import	Opções: New group: importar APIs para um novo grupo de APIs. Se você selecionar essa opção, o sistema criará automaticamente um grupo de APIs e importará as APIs para esse grupo. Existing group: importar APIs para um grupo de APIs existente. Se você selecionar essa opção, o sistema adicionará as APIs ao grupo de APIs selecionado, mantendo as APIs existentes no grupo de APIs.
   API group	Selecione um grupo de API se você definir Import para Existing group.
   Basic Definition Overwrite	Determine se deve substituir uma API existente se o nome da API for o mesmo de uma API importada. Este parâmetro está disponível somente se você definir Import para Existing group.
   Extended Definition Overwrite	Se essa opção estiver selecionada, os itens de definição estendida (controle de acesso e políticas de limitação de solicitações) de uma API importada substituirão as políticas existentes com o mesmo nome.

8. Na área Parameter Import, clique em File e selecione um arquivo a ser importado.
   Arquivos YAML e JSON são suportados. Você pode visualizar o conteúdo da API a ser importado na página Import API.

   Figura 2 Importação de parâmetro
   

9. (Opcional) Defina configurações globais para as APIs a serem importadas.

   Você pode definir as configurações globais das APIs, como solicitações de front-end e back-end ou modificar outros parâmetros das APIs.

   Figura 3 Configuração de configurações globais
   
   Figura 4 Modificação de APIs
   

10. Clique em Import Now para importar as APIs.
    

    As APIs importadas devem ser publicadas manualmente para que fiquem disponíveis para acesso dos usuários.

Operações de acompanhamento

Publique a API importada em um ambiente para que possa ser chamada pelos usuários.