Verdade corporativa em ação: hub de APIs da Apigee alimentando poderosos portais para desenvolvedores

Na equipe Apigee do Google Cloud, nos dedicamos a fornecer as estratégias e ferramentas de que nossos clientes precisam para criar ecossistemas de APIs robustos e eficazes. Um dos aspectos mais críticos da criação de um ecossistema de API bem-sucedido é fornecer a produtores e consumidores maneiras de descobrir APIs. Recebemos pedidos frequentes para explicar a diferença entre duas partes distintas, mas profundamente conectadas, da plataforma Apigee que ajudam nisso: o hub de APIs da Apigee e os portais para desenvolvedores. Embora, à primeira vista, possa parecer que essas ferramentas desempenham funções semelhantes, na verdade, elas são projetadas para atender a diferentes necessidades de diferentes perfis. É fundamental reconhecer como o hub de APIs da Apigee atua como o mecanismo central e uma fonte da verdade que capacita e eleva a funcionalidade dos portais para desenvolvedores e serve como uma base essencial para estratégias agênticas.

Hub de APIs da Apigee: a fonte da verdade para todas as APIs em toda a empresa

É útil pensar no hub de APIs da Apigee como o sistema nervoso central de seu programa de APIs. Ao oferecer um local centralizado para catalogar todas as APIs e os dados de APIs na organização (independentemente do estilo, da fase do ciclo de vida ou do ambiente de hospedagem da API), o hub de APIs da Apigee pode se tornar a fonte oficial da "verdade corporativa", fornecendo a base para governança e consistência e permitindo que as equipes evitem a proliferação, criem APIs melhores e, consequentemente, ofereçam experiências melhores aos usuários.

É importante notar que o foco do hub de APIs da Apigee está principalmente nas necessidades dos produtores de APIs dentro da organização: engenheiros de plataforma, arquitetos de API, profissionais de segurança e, é claro, os desenvolvedores responsáveis pela criação e pelo gerenciamento de APIs. Para esses usuários, o hub de APIs da Apigee é a única fonte da verdade e inclui:

• Um panorama abrangente de todas as suas APIs e seus metadados: o hub de APIs da Apigee pode descobrir e catalogar automaticamente todas as suas APIs, criando um repositório unificado com metadados avançados. Isso inclui informações sobre as fases do ciclo de vida, as versões, as especificações e a documentação das APIs, fornecendo uma visão completa e precisa do ecossistema de APIs. Esses dados abrangentes e legíveis por máquina são precisamente o que os agentes de IA necessitam para entender e interagir com sistemas corporativos, atuando como o registro essencial de serviços.

• Governança centralizada e baseada em padrões: o hub permite que você estabeleça e aplique uma governança consistente em todo o ciclo de vida das APIs. Ao manter uma única fonte da verdade, você pode garantir efetivamente a qualidade consistente e a adesão a padrões, gerenciar a segurança, monitorar a maturidade das APIs e tomar decisões informadas sobre a estratégia de APIs, por exemplo, ao identificar APIs que podem ser monetizadas. Essa fonte unificada da verdade é crucial para estabelecer governança não apenas para desenvolvedores humanos, mas também para controlar e assegurar a forma como os agentes de IA acessam e utilizam seu portfólio de APIs, garantindo consistência em segurança, estilos de APIs e formatos de dados.

• Colaboração interna aprimorada: o hub promove a colaboração interna ao fornecer uma fonte centralizada e consistente de informações sobre as APIs. Isso incentiva a reutilização de APIs, reduz a redundância e agiliza os fluxos de trabalho de desenvolvimento.

Portais para desenvolvedores: experiências sob medida para consumidores de APIs

Os portais para desenvolvedores, por outro lado, são como vitrines através das quais os consumidores de APIs — os desenvolvedores que criam aplicativos — descobrem as APIs e interagem com elas. É crucial reconhecer que nem todas as APIs produzidas dentro de uma organização são destinadas ao consumo externo. O hub de APIs da Apigee, como um superconjunto, gerencia todas as APIs, enquanto os portais para desenvolvedores expõem um subconjunto cuidadosamente selecionado dessas APIs, usando identidades visuais e estilos personalizados.

Para serem verdadeiramente eficazes, esses portais devem ser alimentados pela "verdade corporativa" residente no hub de APIs da Apigee. Os portais oferecem um subconjunto com curadoria e fácil de usar dos recursos do hub, com foco no consumo otimizado das APIs:

• Descoberta de APIs verdadeira e eficaz: os portais para desenvolvedores dependem da acurácia e integridade dos metadados do hub de APIs da Apigee para permitir que os desenvolvedores encontrem facilmente as APIs de que precisam.

• A "plataforma de lançamento" para o consumo de APIs: o hub de APIs da Apigee atua como o centro de controle, fornecendo uma "plataforma de lançamento" governada (exemplo) para publicar seletivamente APIs específicas e sua "verdade corporativa" associada em portais para desenvolvedores. Isso garante que apenas APIs aprovadas e relevantes sejam disponibilizadas para consumo.

Desbloqueie o potencial de suas APIs

O hub de APIs da Apigee e os portais para desenvolvedores, embora distintos, formam um sistema unificado. O catálogo abrangente e a "verdade corporativa" do hub habilitam e orientam diretamente a experiência dos desenvolvedores no portal e, agora, criticamente, atuam como a base indispensável para o crescente número de estratégias de agentes de IA.

Ao entenderem o papel do hub de APIs da Apigee como repositório central para os produtores de APIs e o núcleo fundamental para os agentes, assim como a função do portal como um subconjunto com foco no consumidor com uma "plataforma de lançamento" governada, as organizações podem desbloquear totalmente o potencial de suas APIs e acelerar a inovação.

Simplifique o gerenciamento de APIs com o hub de APIs da Apigee e os portais para desenvolvedores

• Comece a usar o hub de APIs da Apigee e importe APIs de seus projetos Apigee existentes, preparando o terreno para seu futuro agêntico.

• Comece a usar os portais para desenvolvedores da Apigee.

• Experimente este exemplo no GitHub, que mostra como integrar APIs não gerenciadas ao hub e publicar a documentação em um portal para desenvolvedores.

• Em 31 de julho de 2025, junte-se a nós para descobrir o que faz o hub e como funciona o portal.

Não pode participar do evento ao vivo? Não se preocupe! Inscreva-se para receber acesso à reprodução e assista quando quiser.