O que é o Centro de APIs do Azure?

O Azure API Center permite-lhe acompanhar todas as suas APIs num local centralizado para descoberta, reutilização e governação. 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.

Sugestão

Começar a usar o API Center ficou mais fácil! O plano gratuito já está disponível sem restrições de tempo. Aplicam-se limites .

Ao utilizar um centro de APIs, as partes interessadas em toda a sua organização – incluindo gestores de programas de API, administradores de TI, programadores de aplicações e programadores de APIs – podem desenhar, 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 serviços complementares, como o Gerenciamento de API do Azure, uma solução para governança de API de 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 trabalhar juntos.

Benefícios

• Crie e mantenha um inventário organizacional – Construa um inventário completo das APIs disponíveis na 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 maior visibilidade das APIs que estão a ser desenvolvidas e utilizadas na sua organização, os gestores de programas e administradores de TI podem governar este inventário para garantir que cumpre os padrões organizacionais, definindo metadados personalizados e analisando definições de APIs para garantir a conformidade com as diretrizes de estilo da API.

• Descoberta fácil de APIs - Promova a reutilização de APIs para maximizar a produtividade dos programadores e garantir que os programadores utilizam 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 um centro de API para as seguintes capacidades:

• Gestão de inventário de APIs - Os programadores e gestores de programas de APIs podem registar todas as APIs da sua organização para inclusão num inventário centralizado utilizando o portal Azure, a CLI do Azure, ferramentas para programadores como pipelines CI/CD e ligações para fontes API, como os serviços de Gestão de APIs Azure.

• Design e desenvolvimento de APIs - Ao utilizar a extensão Azure API Center para Visual Studio Code, os programadores podem registar APIs diretamente a partir do mesmo ambiente de desenvolvimento onde criam as suas APIs e aplicações.

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

• 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.

• Governação da API - Organizar e filtrar APIs e recursos relacionados utilizando metadados incorporados e personalizados, para ajudar na governação e descoberta da API pelos consumidores da API. Configure linting e a análise para impor a qualidade da definição da API.

  Os programadores de APIs podem deslocar para a esquerda verificações de conformidade do design da API para o Visual Studio Code usando suporte integrado para linting e deteção de alterações quebradas. 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. Também pode ativar o portal usando a extensão Azure API Center do Visual Studio Code.

Para mais informações sobre as entidades que pode gerir e as capacidades no Azure API Center, consulte Conceitos-chave.

Níveis e SKUs

O API Center também é oferecido em plano Gratuito e plano Standard. Mais informações.

Nota

O Azure API Center está agora incluído gratuitamente nos níveis Azure API Management Premium e Standard.

Regiões disponíveis

O Centro de API do Azure está atualmente disponível nas seguintes regiões do Azure:

• Leste da Austrália
• Canadá Central
• Índia Central
• E.U.A. Leste
• Centro de França
• Suécia Central
• Sul do Reino Unido
• Europa Ocidental

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 adota uma estratégia API-first, enfatizando a importância das APIs no 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 API da Contoso inclui as seguintes funcionalidades:

• 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. Eles implementam outro subconjunto das suas APIs numa aplicação 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. Utilizam instâncias separadas para desenvolvimento, teste e produção, cada uma com um nome distinto.

• Azure API Center - A Contoso adota o Azure API Center como o seu hub centralizado para descoberta, governação 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.

Próximos passos

Configurar o seu centro de API - portal