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

Pode começar rapidamente com o Azure API Center aproveitando o plano gratuito, que não tem restrições de tempo. Compare os limites do plano Gratuito e do plano Standard.

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 Azure API Management, uma solução para a governação e observabilidade da API em tempo de execução através de um gateway API. Revê as diferenças e vê como podem funcionar em conjunto.

Benefícios

O Azure API Center oferece os seguintes benefícios:

• Crie e mantenha um inventário organizacional: Construa um inventário completo das APIs disponíveis na sua organização. Registe APIs geridas em todas as suas soluções de gestão de APIs, incluindo Azure API Management e plataformas de outros fornecedores. 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.

• Regule as APIs da sua organização: Aceda a uma visibilidade mais completa das APIs que estão a ser desenvolvidas e utilizadas dentro da sua organização. Os gestores de programas da API e os administradores de TI podem governar este inventário para garantir que cumpre os padrões organizacionais, definindo metadados personalizados e analisando definições da API 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 utilizam as APIs certas. O Azure API Center ajuda gestores de programas e programadores a descobrir o inventário e filtrar da API utilizando metadados incorporados e personalizados. ​

• Acelere o consumo de APIs: Maximize a produtividade dos programadores ao consumir APIs e assegure que são consumidas de forma segura, em conformidade 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: Permitir que os programadores e gestores de programas APIs registem todas as APIs da organização para inclusão num inventário centralizado. Podem usar o portal do Azure, a CLI do Azure, ferramentas para programadores, como os pipelines de CI/CD, e ligações para fontes de API, como a gestão de serviços de API do Azure.

• Design e desenvolvimento de APIs: Permitir que os programadores usem a extensão Azure API Center para Visual Studio Code para registar APIs diretamente do mesmo ambiente de desenvolvimento onde criam as suas APIs e aplicações.

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

• Representação da API no mundo real: Adicionar informação do mundo real sobre cada API, incluindo versões e definições como definições OpenAPI. Crie uma lista de implementações de APIs e associe-as a ambientes de execução, por exemplo, represente Azure API Management ou outras soluções de gestão de APIs.

• Governação da API: Organize e filtre 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 as aplicações não usam APIs sombra não registadas ou APIs que não cumpram os padrões organizacionais.

• Descoberta e reutilização de APIs: Permitir que programadores empresariais e gestores de programas de APIs descubram APIs através de um portal Azure API Center. 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 Azure API Center é oferecido em plano Gratuito e plano Standard.

Nota

O Azure API Center também está 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. O seguinte diagrama e explicação demonstram este cenário:

O ecossistema API da Contoso inclui as seguintes funcionalidades:

• Desenvolvimento de APIs: Os programadores da Contoso desenvolvem regularmente ASP.NET APIs web. Eles também criam o Azure Functions com gatilhos HTTP.

• Ambientes de implementação de APIs: A Contoso implementa uma parte das suas APIs no Azure App Service. Eles implementam outro subconjunto das suas APIs numa aplicação Azure Function.

• Azure API Management: A Contoso utiliza o serviço Azure API Management para gerir, publicar e proteger as 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 centro centralizado para descoberta, governação e consumo de APIs. O Azure API Center funciona como um hub de APIs estruturado e organizado que fornece informações abrangentes sobre todas as APIs organizacionais, mantendo informações relacionadas, incluindo versões e implementações associadas.

Conteúdo relacionado

• Crie o seu centro API (portal Azure)