O que é o Centro de API do Azure?

O Centro de API do Azure permite que você acompanhe todas as 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.

Dica

Começar a usar o Centro de API ficou mais fácil! O plano gratuito agora está disponível sem restrições de tempo. Os limites se aplicam.

Usando um centro de API, os stakeholders em toda a sua organização - incluindo gerentes de programas de API, administradores de TI, desenvolvedores de aplicativos e desenvolvedores de API - podem projetar, 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 serviços complementares, como o Azure API Management, uma solução para governança de API em tempo de execução 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 – crie 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 desenvolvidas e usadas em sua 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 conformidade às diretrizes de estilo de API.

• Descoberta fácil de API – promover a reutilização da API para maximizar a produtividade do desenvolvedor e garantir que os desenvolvedores estejam usando as APIs certas. 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 os seguintes recursos:

• Gerenciamento de inventário de API – 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, ferramentas de desenvolvedor, como pipelines de CI/CD e links para fontes de API, como serviços de Gerenciamento de API do Azure.

• Design e desenvolvimento de API – usando a extensão do Centro de API do Azure para Visual Studio Code, os desenvolvedores podem registrar APIs diretamente do mesmo ambiente de desenvolvimento em que criam suas APIs e aplicativos.

  Os desenvolvedores podem aproveitar a integração da extensão com o GitHub Copilot para criar definições de API a partir de código e com o GitHub Copilot para Azure para projetar APIs com assistência de IA.

• 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 – Organize e filtre APIs e recursos relacionados usando metadados internos e personalizados, para ajudar na governança e descoberta de API pelos consumidores de API. Configure lint e análise para impor a qualidade da definição de API.

  Os desenvolvedores de API podem mudar as verificações de conformidade de design de API para a esquerda no Visual Studio Code usando o suporte de linting integrado e a detecção de alterações interruptivas. 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 – permitir que desenvolvedores corporativos e gerentes de programas de API descubram APIs por meio de um portal do Centro de API. Você também pode habilitar o portal usando a extensão do Visual Studio Code do Centro de API do Azure.

Para obter mais informações sobre as entidades que você pode gerenciar e os recursos no Centro de API do Azure, consulte os principais conceitos.

Níveis e SKUs

O Centro de API também é oferecido em um plano gratuito e em um plano Standard. Saiba mais.

Observação

O Centro de API do Azure agora está incluído gratuitamente com as camadas Premium e Standard do Gerenciamento de API do Azure.

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
• Canadá Central
• Índia Central
• Leste dos EUA
• França Central
• Suécia Central
• Sul do Reino Unido
• Oeste da Europa

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 hipotética organização Contoso, que adota uma estratégia de primeira API, enfatizando a importância das APIs em seu desenvolvimento e integração de software.

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 de API da Contoso inclui os seguintes recursos:

• 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. Eles implantam outro subconjunto de suas APIs 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.

• Centro de API do Azure – a Contoso adota 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.

Próximas etapas

Configurar seu centro de API - portal