Partilhar via


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.

Diagrama mostrando o Centro de API em um ecossistema de API de exemplo.

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.

Próximos passos