O que é o hub de APIs da Apigee?

Esta página se aplica à Apigee e à Apigee híbrida.

O hub de APIs da Apigee permite consolidar e organizar informações sobre todas as APIs de interesse da sua organização. O hub de APIs permite coletar informações críticas sobre APIs, permitindo que os desenvolvedores as descubram e avaliem facilmente e potencializem o trabalho de outras equipes sempre que possível. As equipes de plataformas de API podem usar o hub de APIs para ter visibilidade do portfólio de APIs e gerenciá-lo.

Visão geral do hub de APIs.
Figura 1. Com o hub de APIs, você pode importar e registrar APIs, pesquisar APIs, acompanhar dependências, inspecionar especificações de API e muito mais.

O valor do gerenciamento centralizado de APIs

Muitas organizações são desafiadas pelo crescente número de APIs que desenvolvem e usam. Conforme o número de APIs aumenta, elas se tornam mais difíceis de rastrear, o que pode levar à duplicação em vez de uma reutilização, uma ineficiência cara. Quando as APIs se multiplicam sem padrões de design e verificações de governança, o cenário de APIs cresce de forma inconsistente, atrasando as equipes, enquanto um programa de APIs bem organizado pode ajudá-las a trabalhar com mais agilidade.

A experiência do hub de APIs é voltada principalmente para os consumidores e produtores de APIs em uma organização onde as principais preocupações são encontrar, listar, comparar e avaliar APIs dentro e fora do ecossistema de rede da organização. Ele permite gerenciar um catálogo completo de todas as suas APIs com as entidades associadas, incluindo versões de API, dependências, implantações e muito mais. Também é possível associar as especificações das APIs às respectivas versões. Para especificações da OpenAPI, o hub de APIs as analisa e extrai metadados, incluindo operações de API. Além disso, é possível vincular uma versão da API a um endpoint específico de implantação de API.

Principais benefícios do hub de APIs Apigee

Os administradores do hub de APIs podem:

  • adicionar, editar e gerenciar um catálogo completo de todas as APIs, além das entidades associadas a elas;
  • gerenciar todo o ciclo de vida da API com suporte para controle de versões, vinculando versões às especificações da API, exibindo as operações analisadas em uma especificação, vinculando uma versão de API a um endpoint específico de implantação e mais;
  • adicionar atributos ao seu conjunto de APIs e incluir tags nelas com vários estágios do ciclo de vida, informações de conformidade e outras informações que você quer monitorar;
  • filtrar e pesquisar APIs com base em um conjunto avançado de atributos;
  • Vincule o hub de APIs a um ou mais projetos híbridos da Apigee para buscar automaticamente as informações do proxy de API da Apigee e armazená-las no hub de APIs. O hub de APIs executa periodicamente (uma vez a cada seis horas) um programador que se conecta ao projeto da Apigee e recebe as definições de proxy mais recentes;
  • usar recursos avançados de pesquisa semântica para encontrar APIs com pesquisa em formato livre;
  • Monitorar a conformidade dos seus arquivos de especificação de API usando a funcionalidade de inspecionar.
  • monitorar as dependências das APIs modelando dependências entre várias operações nas APIs;
  • armazenar dados do ciclo de vida da API.

Com o hub de APIs, você reúne informações valiosas sobre suas APIs em um só lugar para acelerar a consistência, o uso, a reutilização e a governança do seu portfólio de APIs.

Principais recursos e conceitos

Recursos de API

Um recurso de API representa uma API que existe no ecossistema de rede da sua organização. Os recursos armazenados no hub da API são pesquisáveis e fornecem informações operacionais e descritivas detalhadas sobre a API, como implantações, versões, operações, estágio do ciclo de vida e outros atributos importantes.

Controle de versões

A capacidade de modelar e organizar as versões da API é um recurso importante do hub de API. Cada recurso de API no hub de API tem pelo menos uma versão associada a ele. Pense na versão como o estado de uma API em um determinado momento. Basicamente, as versões ajudam você a agrupar e organizar suas APIs com base em conjuntos subjacentes de operações, implantações e outros metadados.

Fazer o registro automático dos proxies de API da Apigee

O registro automático refere-se a receber dados da API de sistemas externos no hub de APIs. É possível registrar todos os proxies presentes em um projeto da Apigee ou em de ambiente de execução híbrido Apigee ou diretamente no hub de API anexando o projeto de ambiente de execução ao hub de API. Consulte Fazer o registro automático de proxies da Apigee.

Análise e inspeção de especificações

Outro recurso importante do hub de API é a capacidade de analisar determinadas especificações da API, como as da OpenAPI, nas definições, operações e outros componentes essenciais e armazenar essas informações com um recurso de API. O hub de API também fornece feedback de inspeção para especificações importadas.

Pesquisando

Os avançados recursos de pesquisa do hub de API são compatíveis com operações de pesquisa baseadas em texto livre e em filtros que permitem pesquisar com base em qualquer parte da definição da API. Com essas poderosas ferramentas de pesquisa, é possível identificar o recurso de API que atende a casos de uso específicos, evitando a recriação ou duplicação de esforços de engenharia de API.

Mapeamento de dependências

As dependências do hub de APIs ajudam você a ver e gerenciar as relações da cadeia de suprimentos entre as APIs. Encontrar e monitorar as dependências de uma API ajuda você a gerenciar seu ecossistema de APIs com mais eficiência e a resolver problemas de operações de API corrompidas.

A seguir