Tutorial: Registrar APIs em seu inventário de APIs

Este tutorial explica como iniciar o inventário de API no centro de API da sua organização registrando APIs e atribuindo metadados usando o portal do Azure.

Para obter mais informações sobre APIs, versões de API, definições e outras entidades que você pode inventariar na Central de APIs do Azure, consulte Principais conceitos.

Neste tutorial, você aprenderá a usar o portal do Azure para:

• Registrar uma ou mais APIs
• Adicionar uma versão da API com uma definição de API

Pré-requisitos

• Um centro de API na sua subscrição do Azure. Para criar um, consulte Guia de início rápido: criar sua central de APIs.

• Uma ou mais APIs que você deseja registrar em seu centro de APIs. Aqui estão dois exemplos, com links para suas definições de OpenAPI:

  • Swagger Petstore API
  • API de conferência

• Defina metadados personalizados para suas APIs concluindo o tutorial anterior, Definir metadados personalizados.

Registrar APIs

Quando você registra (adiciona) uma API em seu centro de APIs, o registro da API inclui:

• Um título (nome), tipo e descrição
• Informações sobre a versão
• Links opcionais para documentação e contatos
• Metadados internos e personalizados que você definiu

Depois de registrar uma API, você pode adicionar versões e definições à API.

As etapas a seguir registram duas APIs de exemplo: Swagger Petstore API e Conference API (consulte Pré-requisitos). Se preferir, registre suas próprias APIs.

1. Entre no portal do Azure e navegue até o centro de APIs.

2. No menu da barra lateral, em Ativos, selecione APIs>+ Registrar uma API.

3. Na página Registrar uma API, adicione as seguintes informações para a API do Swagger Petstore. Você deve ver os metadados personalizados de Linha de negócios e voltados para o público que você definiu no tutorial anterior na parte inferior da página.

   Configuração	Valor	Description
   Título da API	Entre na API do Swagger Petstore.	Nome escolhido para a API
   Identificação	Depois de inserir o título anterior, a Central de API do Azure gera esse identificador, que você pode substituir.	Nome do recurso do Azure para a API
   Tipo de API	Selecione REST na lista suspensa.	Tipo de API
   Resumo	Opcionalmente, insira um resumo.	Descrição resumida da API
   Descrição	Opcionalmente, insira uma descrição.	Descrição da API
   Versão
   Título da versão	Insira um título de versão de sua escolha, como v1.	Nome escolhido para a versão da API
   Identificação da versão	Depois de inserir o título anterior, a Central de API do Azure gera esse identificador, que você pode substituir.	Nome do recurso do Azure para a versão
   Ciclo de vida da versão	Faça uma seleção na lista suspensa, por exemplo, Teste ou Produção.	Estágio do ciclo de vida da versão da API
   Documentação externa	Opcionalmente, adicione um ou mais links para documentação externa.	Nome, descrição e URL da documentação da API
   Licença	Opcionalmente, adicione informações de licença.	Nome, URL e ID de uma licença para a API
   Informação de Contacto	Opcionalmente, adicione informações para um ou mais contatos.	Nome, e-mail e URL de um contato para a API
   Linha de negócio	Se você adicionou esses metadados no tutorial anterior, faça uma seleção na lista suspensa, como Marketing.	Metadados personalizados que identificam a unidade de negócios proprietária da API
   Voltado para o público	Se você adicionou esses metadados, marque a caixa de seleção.	Metadados personalizados que identificam se a API é voltada para o público ou apenas interna

   

4. Selecione Criar para registrar a API.

5. Repita as três etapas anteriores para registrar outra API, como a API de conferência.

Sugestão

Ao registrar uma API no portal do Azure, você pode selecionar qualquer um dos tipos de API predefinidos ou inserir outro tipo de sua escolha.

As APIs aparecem na página APIs no portal. Se você adicionar um grande número de APIs ao centro de APIs, use a caixa de pesquisa e os filtros nesta página para encontrar as APIs desejadas.

Depois de registrar uma API, você pode visualizar ou editar as propriedades da API. Na página APIs, selecione a API para ver as páginas para gerenciar o registro da API.

Adicionar uma versão da API

Ao longo de seu ciclo de vida, uma API pode ter várias versões. Você pode adicionar uma versão a uma API existente em seu centro de APIs, opcionalmente com um arquivo ou arquivos de definição.

Aqui você adiciona uma versão a uma de suas APIs:

1. No portal do Azure, navegue até o centro de APIs.

2. No menu da barra lateral, selecione APIs e, em seguida, selecione uma API, por exemplo, Swagger Petstore.

3. Na página API, em Detalhes, selecione >.

   

4. Na página Adicionar versão da API , insira ou selecione as seguintes informações em Detalhes da versão:

   Configuração	Valor	Description
   Título da versão	Insira um título de versão de sua escolha, como v2.	Nome escolhido para a versão da API
   Identificação da versão	Depois de inserir o título anterior, a Central de API do Azure gera esse identificador, que você pode substituir.	Nome do recurso do Azure para a versão
   Ciclo de vida da versão	Faça uma seleção na lista suspensa, como Produção.	Estágio do ciclo de vida da versão da API

5. O Centro de API do Azure dá suporte a definições em formatos comuns de especificação de texto, como OpenAPI 2 e 3 para APIs REST. Para adicionar uma definição de API, insira ou selecione as seguintes informações em Selecionar uma especificação:

   Configuração	Valor	Description
   Título da definição	Insira um título de sua escolha, como Definição v2.	Nome escolhido para a definição da API
   Identificação da definição	Depois de inserir o título anterior, a Central de API do Azure gera esse identificador, que você pode substituir.	Nome do recurso do Azure para a definição
   Descrição	Opcionalmente, insira uma descrição.	Descrição da definição da API
   Formato da especificação	Para a API Petstore, selecione OpenAPI.	Formato de especificação para a API
   Versão da especificação	Insira um identificador de versão de sua escolha, como 3.0.	Versão da especificação
   Ficheiro ou URL	Navegue até um arquivo de definição local para a API Petstore ou insira uma URL. URL de exemplo: https://raw.githubusercontent.com/swagger-api/swagger-petstore/refs/heads/master/src/main/resources/openapi.yaml	Arquivo de definição de API

   

6. Selecione Criar.

À medida que você cria seu inventário de APIs, aproveite as ferramentas automatizadas para registrar APIs, como a extensão do Centro de API do Azure para Visual Studio Code e a CLI do Azure.

Próximo passo

Seu inventário de API está começando a tomar forma! Agora você pode adicionar informações sobre ambientes e implantações de API.

Adicionar ambientes e implantações de API