Compartilhar via

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

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

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 Gerenciamento de API do Azure, uma solução para governança de API de runtime e observabilidade usando um gateway de API. Examine as diferenças e veja como elas podem trabalhar juntas.

Benefícios

O Centro de API do Azure oferece os seguintes 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: acesse 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 os gerentes de programas e os desenvolvedores a descobrir o inventário e o filtro da API 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: permitir que desenvolvedores de API e gerentes de programas de API registrem todas as APIs da organização para inclusão em um inventário centralizado. Eles podem usar 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: permitir que os desenvolvedores usem a extensão do Centro de API do Azure para Visual Studio Code para 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 do código e do GitHub Copilot para a Azure para criar APIs com assistência de IA.

  • Representação da API do mundo real: adicione informações reais sobre cada API, incluindo versões e definições, como definições de OpenAPI. Crie uma lista de implantações de API e associe-as a ambientes de runtime, por exemplo, representam 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 da API para a esquerda no Visual Studio Code usando o suporte para lint integrado e a detecção de alterações significativas. Integre-se a ferramentas como o Proxy de Desenvolvimento 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: permitir que desenvolvedores empresariais e gerentes de programas de API descubram APIs por meio de um portal do Centro de API do Azure. 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 do Azure é oferecido em um plano gratuito e plano Standard.

Observação

O Centro de API do Azure também 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. O diagrama e a explicação a seguir demonstram este cenário:

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

O ecossistema de API da Contoso inclui os seguintes recursos:

  • Desenvolvimento de API: os desenvolvedores da Contoso criam regularmente ASP.NET APIs Web. Eles também criam 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 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 suas APIs. 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 do Azure 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.

Conteúdo relacionado

  • Last updated on