O que é o Centro de API do Azure (visualização)?
A Central de APIs permite rastrear todas as suas APIs em um local centralizado para deteção, reutilização e governança. Use a Central de APIs para desenvolver e manter um inventário estruturado e organizado das APIs da sua organização, independentemente do tipo, do estágio do ciclo de vida ou do local de implantação, juntamente com informações relacionadas, como detalhes da versão, arquivos de definição de API e metadados comuns.
Com o Centro de APIs, as partes interessadas em toda a organização - incluindo gerentes de programas de API, administradores de TI, desenvolvedores de aplicativos e desenvolvedores de API - podem descobrir, reutilizar e controlar APIs.
Importante
- O Centro de API está em pré-visualização. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e, ocasionalmente, pode esperar alterações significativas durante a pré-visualização. Alterações no modelo de dados de visualização do Centro de API podem levar à perda de dados. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.
- Durante a visualização, solicite recursos, relate bugs ou forneça outros comentários neste repositório GitHub.
Nota
O Centro de API é uma solução para as organizações catalogarem e gerenciarem seu inventário de APIs. O Azure também oferece o serviço de Gerenciamento de API, uma solução para gerenciar, proteger e publicar os back-ends de API da sua organização por meio de um gateway de API. Saiba mais sobre a diferença.
Benefícios
Criar e manter um inventário organizacional - As organizações podem criar um inventário completo das APIs disponíveis em sua organização. Promova a comunicação e permita que os gerentes e desenvolvedores de programas de API colaborem para aumentar a reutilização, a qualidade, a segurança, a conformidade e a produtividade do desenvolvedor da API.
Governe as APIs da sua organização - Com uma visibilidade mais completa das APIs que estão sendo produzidas e usadas em uma organização, os gerentes de programas de API e os administradores de TI podem controlar esse inventário para garantir que ele atenda aos padrões organizacionais, definindo metadados personalizados e analisando definições de API para impor a conformidade com as diretrizes de estilo de API.
Descoberta fácil de API - As organizações querem promover a reutilização da API para maximizar a produtividade do desenvolvedor e garantir que ele esteja usando as APIs certas. A Central de APIs ajuda os gerentes de programas e desenvolvedores a descobrir o inventário e o filtro da API usando propriedades de metadados internas e personalizadas.
Acelere o consumo de API - Maximize a produtividade do desenvolvedor ao consumir APIs e garanta que elas sejam consumidas de forma segura e consistente com os padrões organizacionais.
Capacidades chave
Na visualização, crie e use uma central de API no portal do Azure para o seguinte:
Gerenciamento de inventário de API - Registre todas as APIs da sua organização para inclusão em um inventário centralizado.
Representação de API do mundo real - Adicione informações do mundo real sobre cada API, incluindo versões e definições, como definições de OpenAPI. Liste implantações de API e associe-as a ambientes de tempo de execução, por exemplo, representando o Gerenciamento de API do Azure ou outras soluções de gerenciamento de API.
Governança de API - Organize e filtre APIs e recursos relacionados usando propriedades de metadados internas e personalizadas, para ajudar com a governança de API e a descoberta por consumidores de API. Configure o forro e a análise para impor a qualidade da definição da API.
Descoberta e reutilização de API - Permita que desenvolvedores e gerentes de programas de API descubram APIs por meio do portal do Azure, um portal da Central de APIs e ferramentas de desenvolvedor, incluindo uma extensão do Visual Studio Code integrada ao GitHub Copilot.
Para obter mais informações sobre as entidades que você pode gerenciar e os recursos no Centro de APIs, consulte Principais conceitos.
Regiões disponíveis
A Central de API está atualmente disponível nas seguintes regiões do Azure:
- Leste da Austrália
- Índia Central
- E.U.A. Leste
- Sul do Reino Unido
- Europa Ocidental
Centro de API e o ecossistema de API
O Centro de API pode desempenhar um papel fundamental no ecossistema de API de uma organização. Considere a hipotética organização Contoso, que adotou uma estratégia API-first, enfatizando a importância das APIs em seu desenvolvimento e integração de software.
Os desenvolvedores de API, desenvolvedores de aplicativos, gerentes de programas de API e gerentes de API da Contoso colaboram por meio da Central de APIs do Azure para desenvolver e usar o inventário de API da organização. Veja o diagrama e a explicação a seguir.
O ecossistema de API da Contoso inclui o seguinte:
Desenvolvimento de API - os desenvolvedores da Contoso criam regularmente APIs Web ASP.NET. Eles também criam o Azure Functions com gatilhos HTTP.
Ambientes de implantação de API - A Contoso implanta uma parte de suas APIs no Serviço de Aplicativo do Azure. Outro subconjunto de suas APIs é implantado em um aplicativo do Azure Function.
Gerenciamento de API - A Contoso usa o Gerenciamento de API do Azure para gerenciar, publicar e proteger suas APIs. Eles usam instâncias separadas para Desenvolvimento, Teste e Produção, cada uma com um nome distinto: APIM-DEV, APIM-TEST e APIM-PROD.
Centro de API - A Contoso adotou o Centro de API do Azure como seu hub centralizado para descoberta, governança e consumo de API. O Centro de API serve como um hub de API estruturado e organizado que fornece informações abrangentes sobre todas as APIs organizacionais, mantendo informações relacionadas, incluindo versões e implantações associadas.
Perguntas mais frequentes
P: Qual é a diferença entre o Gerenciamento de API do Azure e o Centro de API do Azure?
R: O Gerenciamento de API do Azure é um serviço do Azure totalmente gerenciado que ajuda as organizações a expor com segurança suas APIs para clientes externos e internos. Ele fornece um conjunto de ferramentas e serviços para criar, publicar e gerenciar APIs, bem como reforçar a segurança, dimensionar e monitorar o uso da API.
Por outro lado, o Centro de API do Azure ajuda as organizações a criar um catálogo de APIs que estão disponíveis dentro da organização. A Central de APIs do Azure fornece informações básicas sobre as APIs, como nome, descrição e versão, mas informações adicionais podem ser adicionadas a essas APIs usando metadados personalizados. O Centro de API do Azure ajuda diferentes partes interessadas, como gerentes de API ou desenvolvedores de API, a descobrir e reutilizar APIs existentes na organização.
Embora ambos os serviços forneçam ferramentas para governar APIs, eles servem a finalidades diferentes. O Gerenciamento de API do Azure é uma plataforma para criar, publicar e gerenciar APIs, enquanto a Central de APIs fornece um local centralizado para descobrir e reutilizar APIs existentes em uma organização.
P: Como faço para usar o Centro de API com minha solução de Gerenciamento de API?
R: O Centro de API é um serviço autónomo do Azure que é complementar ao Azure API Management e aos serviços de gestão de API de outros fornecedores. O Centro de API fornece um inventário de API unificado para todas as APIs na organização, incluindo APIs que não são executadas em gateways de API (como as que ainda estão em design) e aquelas que são gerenciadas com diferentes soluções de gerenciamento de API.
Para APIs gerenciadas usando uma solução de gerenciamento de API, a Central de APIs pode armazenar metadados, como o ambiente de tempo de execução e detalhes de implantação.
P: Os meus dados estão encriptados no Centro de API?
R: Sim, todos os dados no Centro de API são criptografados em repouso.