O que é o Centro de API do Azure?
O Centro de API do Azure permite o acompanhamento de todas as suas APIs em um local centralizado para descoberta, reutilização e governança. Use um centro de API para desenvolver e manter um inventário estruturado e organizado das APIs da sua organização, seja qual for o tipo, a fase do ciclo de vida ou o local da implantação, acompanhado de informações relacionadas, como detalhes da versão, arquivos de definição de API e metadados comuns.
Com um centro de API, as partes interessadas em toda a sua organização, incluindo gerentes de programas de API, administradores de TI, desenvolvedores de aplicativos e desenvolvedores de API, podem descobrir, reutilizar e governar APIs.
Observação
O Centro de API do Azure é uma solução para descoberta de API centralizada e de governança de API em tempo de design. O Azure também oferece o serviço de Gerenciamento de API, uma solução para governança de API de runtime e observabilidade usando um gateway de API. Saiba mais sobre as diferenças e como o Centro de API do Azure e o Gerenciamento de API podem funcionar juntos.
Benefícios
Criar e manter um inventário organizacional – As organizações podem criar um inventário completo de APIs disponíveis em sua organização. Registre APIs gerenciadas em todas as suas soluções de gerenciamento de API, incluindo o Gerenciamento de API do Azure e plataformas de outros provedores. Inclua também suas APIs não gerenciadas e APIs que se encontram em desenvolvimento. 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 às diretrizes de estilo de API.
Descoberta de API Fácil – as organizações desejam promover a reutilização da API para maximizar a produtividade do desenvolvedor e garantir que os desenvolvedores estejam usando as APIs corretas. O Centro de API do Azure ajuda gerentes de programas e desenvolvedores a descobrir o inventário de API e filtrar usando metadados internos e personalizados.
Acelerar o consumo de API – maximizar a produtividade do desenvolvedor ao consumir APIs e garantir que elas sejam consumidas de maneira segura e consistente com os padrões organizacionais.
Principais recursos
Crie e use um centro de API para o seguinte:
Gerenciamento de inventário de API: Desenvolvedores de API e gerentes de programas de API podem registrar todas as APIs da sua organização em um inventário centralizado usando o portal do Microsoft Azure, a CLI do Azure ou ferramentas de desenvolvedor, incluindo a extensão do Centro de API do Azure para Visual Studio Code e pipelines CI/CD.
Representação da API no mundo real – Adiciona informações reais sobre cada API, incluindo versões e definições, como as definições da OpenAPI. Listar implantações de API e associá-las a ambientes de runtime, por exemplo, representando o Gerenciamento de API do Azure ou outras soluções de gerenciamento de API.
Governança de API – Organiza e filtra APIs e recursos relacionados usando os metadados integrados internos e personalizados, para ajudar na governança da API e na capacidade de descoberta pelos consumidores da API. Configure lint e análise para impor a qualidade da definição de API. Desenvolvedores de API podem antecipar a conformidade do design de API no Visual Studio Code com suporte integrado de lint e detecção de alterações críticas. Integre-se a ferramentas como o Proxy de Desenvolvimento para garantir que os aplicativos não usem APIs de sombra não registrados ou APIs que não atendam aos padrões organizacionais.
Descoberta e reutilização de API: Permita que desenvolvedores empresariais e gerentes de programas de API descubram APIs por meio de um portal do Centro de API ou um catálogo de plataforma de API que é acessado usando a extensão do Centro de API do Azure para Visual Studio Code.
Para obter mais informações sobre as entidades que é possível gerenciar e os recursos no Centro de API do Azure, consulte os Principais conceitos.
Regiões disponíveis
Na versão prévia, o Centro de API do Azure está disponível nas seguintes regiões do Azure:
- Leste da Austrália
- Índia Central
- Leste dos EUA
- Sul do Reino Unido
- Europa Ocidental
O Centro de API é oferecido em um plano gratuito e um plano Standard. Saiba mais.
Centro de API do Azure e ecossistema de API
O Centro de API do Azure pode fazer um papel fundamental no ecossistema de API de uma organização. Considere a organização fictícia Contoso, que adotou uma estratégia de priorização de API, enfatizando a importância das APIs no desenvolvimento e integração de software da empresa.
Os desenvolvedores de API, os desenvolvedores de aplicativos, os gerentes de programas de API e os gerentes de API da Contoso colaboram por meio do Centro de API 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 inclui o seguinte:
Desenvolvimento de API – os desenvolvedores da Contoso criam regularmente APIs Web ASP.NET. Eles também criam Azure Functions com gatilhos HTTP.
Ambientes de implantação de API – a Contoso implanta uma parte das APIs deles no Serviço de Aplicativo do Azure. Outro subconjunto das APIs deles é implantado em um aplicativo de funções do Azure.
Gerenciamento de API do Azure – A Contoso usa o serviço de Gerenciamento de API do Azure para gerenciar, publicar e proteger as APIs deles. 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 do Azure – A Contoso adotou o Centro de API do Azure como o hub centralizado deles para descoberta, governança e consumo de APIs. 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.