O que é o Centro de APIs do Azure?
A Central de APIs do Azure permite rastrear 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 - independentemente do tipo, estágio do ciclo de vida ou local de implantação - juntamente com informações relacionadas, como detalhes da versão, arquivos de definição de API e metadados comuns.
Com um 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 governar APIs.
Nota
O Centro de API do Azure é uma solução para governança de API em tempo de design e descoberta centralizada de API. O Azure também oferece o serviço de Gerenciamento de API, uma solução para governança e observabilidade de API de tempo de execução 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 trabalhar juntos.
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. 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 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 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 API do Azure ajuda os gerentes de programa e desenvolvedores a descobrir o inventário e o filtro de API usando metadados internos e personalizados.
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
Crie e use uma central de API para o seguinte:
Gerenciamento de inventário de API - Os desenvolvedores de API e gerentes de programas de API podem registrar todas as APIs da sua organização para inclusão em um inventário centralizado usando o portal do 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 de CI/CD.
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 metadados internos e personalizados, 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. Os desenvolvedores de API podem deslocar as verificações de conformidade do design da API para a esquerda no Visual Studio Code com suporte integrado a linting e deteção de alterações de quebra. Integre com ferramentas como o Dev Proxy para garantir que os aplicativos não usem APIs de sombra não registradas ou APIs que não atendam aos padrões organizacionais.
Descoberta e reutilização de API - Permita que desenvolvedores corporativos e gerentes de programas de API descubram APIs por meio de um portal da Central de APIs ou de um catálogo de plataforma de API acessado usando a extensão de Código do Visual Studio do Centro de API do Azure.
Para saber mais sobre as entidades que você pode gerenciar e os recursos na Central de API do Azure, consulte Principais conceitos.
Regiões disponíveis
O Centro de API do Azure 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
O Centro de API é oferecido em um plano gratuito e um plano Standard. Mais informações.
Centro de API do Azure e o ecossistema de API
A Central de API do Azure pode desempenhar uma função 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 do Azure - A Contoso usa o serviç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 do Azure - 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.