No início dos anos 2000, o cenário tecnológico testemunhou uma mudança à medida que as empresas começaram a reconhecer o valor de oferecer APIs para parceiros e terceiros. Isso apresentou um novo desafio: como organizar e compartilhar essas APIs de forma eficaz, juntamente com sua documentação. Com esse desafio, surgiu também uma compreensão mais profunda da importância da experiência do desenvolvedor de API.
Entendendo a experiência do desenvolvedor de API
A experiência do desenvolvedor de API refere-se a quão fácil e agradável é para os desenvolvedores usar e integrar uma API. Inclui aspectos como documentação clara, design intuitivo, desempenho confiável e suporte útil, que tornam o processo suave e eficiente.
Se você já trabalhou com APIs, provavelmente está familiarizado com os portais de API, projetados para fornecer definições de API, documentação e descrições de métodos. Esses portais eram essenciais para navegar nos primeiros dias da adoção de APIs.
À medida que avançamos para a era da Web 2.0, as APIs tornaram-se cada vez mais cruciais para conectar sites e aplicativos a recursos externos, catalisando o crescimento da “economia de API”. Uma nova pesquisa sobre maturidade de API revela que as APIs agora fazem parte da estratégia de entrada no mercado para 99,5% das organizações.
Esse período viu um aumento na adoção de APIs, impulsionado por serviços em nuvem, aplicativos móveis e plataformas SaaS. Os portais de API evoluíram para hubs sofisticados, oferecendo recursos como documentação abrangente, onboarding, testes e gerenciamento de chaves.
Os ambientes de TI atuais, caracterizados por ambientes multivendor e ecossistemas digitais complexos, exigem mais do que esses recursos fundamentais. As empresas hoje reconhecem que o valor de suas APIs não está apenas em sua existência, mas em seu consumo – ou, em outras palavras, que o maior ROI de API depende de um maior consumo de API.
É aí que entra o Amplify Enterprise Marketplace da Axway. Lançado em 2022 como parte da linha de produtos Amplify, ele representa um avanço significativo na gestão de APIs. Projetado para atender às necessidades dos desenvolvedores modernos, o Amplify Enterprise Marketplace oferece uma experiência completa de marketplace, permitindo que você descubra, organize, governe, proteja e consuma APIs como ofertas de produtos refinados.
Vamos nos aprofundar em seis elementos críticos de uma boa experiência do desenvolvedor de API – e por que um marketplace de API impulsiona uma maior adoção de API, tornando mais fácil e agradável usar suas APIs.
Desenvolvedores nos papéis de provedor de API e consumidor de API
Primeiro, é de suma importância definir quais papéis os desenvolvedores podem desempenhar quando falamos de APIs. Cada vez mais, em grandes organizações, as equipes de desenvolvimento são responsáveis por criar aplicações com todas as capacidades de integração incluídas na aplicação (APIs no sentido mais amplo da palavra).
Dois papéis principais podem ser distinguidos quando falamos de desenvolvedores e APIs:
Provedor de API: como parte da aplicação ou (micro) serviço sendo desenvolvido por um desenvolvedor, uma ou mais APIs são criadas. Primeiro, toda API precisa atender aos requisitos mínimos (de segurança) definidos pela organização. Em segundo lugar, a API precisa estar disponível para outros, para promover o máximo de reutilização possível.
Consumidor de API: para evitar duplicar o desenvolvimento do mesmo serviço mais de uma vez, é fundamental que cada desenvolvedor possa facilmente encontrar todas as APIs em um catálogo ou repositório centralizado. Antes de criar uma nova API, cada desenvolvedor deve verificar se a informação de que precisa pode ser entregue por uma API ou uma combinação de APIs já existentes.
Vamos começar analisando as capacidades importantes em um marketplace para desenvolvedores no papel de provedor de API e, em seguida, o que os desenvolvedores no papel de consumidores de API precisam.
1. Automatize a descoberta, validação e monitoramento de APIs
Na pesquisa mencionada anteriormente, 78% dos tomadores de decisão empresariais disseram que não sabem quantas APIs possuem. A falta de um inventário preciso é um risco de segurança preocupante – e, como mencionado anteriormente, também pode levar ao desperdício: é muito difícil para os desenvolvedores reutilizarem uma API antes de criar uma nova, se não conseguem ver facilmente o que está disponível.
As empresas estão lutando para obter a visibilidade e o controle de que precisam, e isso está impactando a experiência do desenvolvedor de API. Desenvolvedores no papel de provedores de API precisam de ferramentas que aproveitem as APIs de seus sistemas-alvo para realizar funções essenciais, como descoberta, validação e monitoramento.
Os Amplify Agents apoiam os desenvolvedores ao automatizar muitas das tarefas tediosas e demoradas associadas à gestão de API.
Os Amplify Agents são aplicações de software leves, disponíveis em dois tipos: o Discovery Agent e o Traceability Agent. Esses agentes atuam como conectores entre seus ambientes de API existentes e o plano de gestão da Axway.
- Com o Discovery Agent, os desenvolvedores podem identificar e catalogar automaticamente todas as APIs dentro de seu ecossistema, simplificando o processo de acompanhar inúmeras APIs.
- O Traceability Agent fornece insights detalhados sobre o uso e o desempenho das APIs, ajudando os desenvolvedores a identificar e resolver rapidamente problemas.
Visão geral de um gateway registrado no Amplify Marketplace, apresentando um agente ativo de descoberta e rastreabilidade.
2. Garanta que os desenvolvedores tenham acesso a todos os ativos em um único lugar
A falta de visibilidade adequada sobre os ativos está piorando com a proliferação de APIs. E um dos aspectos mais desafiadores da gestão de API é a descoberta e o catálogo de APIs em vários ambientes.
A maioria das empresas hoje não possui apenas uma plataforma de API, mas várias, e utilizam múltiplos modelos de API, incluindo REST, eventos e fluxos de integração, espalhados por várias nuvens de diferentes provedores.
Apenas um terço das APIs estão sendo gerenciadas por uma equipe centralizada de operações, de acordo com a pesquisa sobre maturidade de API nas empresas. O restante é deixado para equipes internas individuais ou gerenciado por partes externas.
Para os provedores de API, consolidar todas as APIs em um diretório único e pesquisável, aprimoraria a descoberta, facilitando a localização e a gestão eficaz delas.
Por isso, a Axway oferece agentes para uma variedade de gateways, incluindo AWS, Azure, Apigee, Mulesoft e Kong. Esses agentes podem identificar várias especificações nesses gateways, como Swagger, OpenAPI, AsyncAPI, WSDL e Protobuf, bem como serviços como SOAP, REST, GraphQL e gRPC.
O Service Registry no Amplify Marketplace conecta-se a um agente e funciona como um diretório centralizado que armazena informações detalhadas sobre todas as APIs e serviços disponíveis dentro da sua organização.
Recentemente, expandimos nosso portfólio para incluir novos agentes para Apigee X, GitLab, Kong API Gateway, GitHub e Kafka. Essas adições aprimoram nossa capacidade de suportar uma gama mais ampla de plataformas, permitindo que você consolide APIs de várias fontes em uma visão unificada.
Com o Amplify Marketplace, você se beneficia de uma visão única, facilitando a gestão e a utilização de suas APIs. Seja integrando APIs do GitHub, gerenciando APIs Apigee X ou trabalhando com streams Kafka, o Amplify Marketplace oferece as ferramentas necessárias para simplificar sua estratégia de API.
O registro de serviço exibindo várias APIs descobertas de diferentes gateways.
3. Eleve a segurança e a validação de APIs para desenvolvedores que fornecem APIs
Além de causar uma experiência desarticulada para o desenvolvedor de API, a falta de visibilidade sobre o stack de APIs pode expor uma organização a problemas de monitoramento e governança.
Quando as organizações possuem um ecossistema de API disperso, sem um método claro para impor padrões e práticas de segurança de API, o ônus da segurança das APIs recai totalmente sobre os desenvolvedores.
Isso se reflete em nossa pesquisa recente sobre maturidade de API, onde os tomadores de decisão sentiram que o maior risco de segurança para suas organizações proveniente do uso de APIs é a segurança deixada para as equipes de desenvolvimento, seguido pela falta de inventário preciso de APIs e APIs não gerenciadas.
Outras vulnerabilidades que as empresas enfrentam incluem:
- Configurações de segurança diferentes para APIs internas e externas (46%)
- Consumo de recursos irrestrito (ou seja, ataques DoS — 43%)
- Controles inadequados de acesso e autorização (41%)
- Falta de aplicação de políticas de segurança comuns para APIs (37%)
Os desenvolvedores de APIs não devem carregar sozinhos o fardo de proteger os dados mais sensíveis da sua empresa. Integrar o linting de API diretamente no seu fluxo de trabalho ajuda a manter os mais altos padrões de design e segurança de uma forma mais automatizada e simplificada.
Segurança e conformidade são aspectos críticos da gestão de APIs, e a Plataforma Amplify é projetada para apoiar os desenvolvedores nessas áreas. Uma vez que suas APIs e serviços são descobertos pelos agentes e registrados no Service Registry, o Amplify Marketplace fornece verificações de segurança integradas para garantir sua integridade.
O servidor de linting Spectral integrado avalia automaticamente suas APIs contra regras predefinidas, identificando problemas potenciais no início do ciclo de desenvolvimento. Os desenvolvedores podem personalizar esses conjuntos de regras para alinhar com as necessidades específicas de sua organização, permitindo uma abordagem personalizada que atende a requisitos únicos.
Um processo de validação mais fluido injeta confiança antes de expor APIs para monetização ou uso público, garantindo que sejam projetadas corretamente e atendam a todos os protocolos e diretrizes de segurança necessários.
Com o Spectral integrado à Plataforma Amplify, você pode construir APIs com a certeza de que elas são robustas, seguras e prontas para produção.
Uma API com pontuação baixa em segurança e design avaliada pelo Spectral.
4. Equipar os provedores de API para entregar valor aos consumidores de API com a produtização de API
Tratar APIs como produtos — e não apenas interfaces técnicas — é fundamental para o sucesso. Aproximadamente 80% das organizações oferecem produtos digitais hoje, conforme a pesquisa de maturidade de API mencionada anteriormente.
Mas o que, exatamente, constitui um produto de API? Os participantes da nossa pesquisa consideram que métricas de desempenho e documentação de negócios/técnica tornam um produto de API eficaz.
Os desenvolvedores de API precisam saber a qualidade de suas APIs (métricas de desempenho e SLA) e como elas estão sendo utilizadas (métricas de uso), e os consumidores de API precisam saber como (documentação técnica) — e por que (documentação de negócios) — usá-las.
Outras capacidades, como fóruns comunitários e avaliações, sandbox de testes, planos de assinatura fáceis de usar ou código de exemplo, também contribuem para construir um produto de API mais completo.
Transformar APIs em produtos prontos para o mercado é essencial para maximizar seu valor, por isso o Amplify Marketplace da Axway oferece recursos direcionados para simplificar esse processo.
Integre a documentação existente de vários formatos, para que você possa reutilizar a documentação em vários produtos de API, economizando tempo e garantindo consistência. A plataforma também permite organizar suas APIs em categorias hierárquicas, simplificando sua gestão e descoberta, mesmo em grandes inventários.
Os desenvolvedores no papel de provedores de API podem colaborar com papéis orientados para negócios para transformar APIs em produtos reais para reutilização ou monetização. O Amplify Marketplace facilita essa colaboração, oferecendo ferramentas para embalar e apresentar APIs como produtos refinados e prontos para uso.
Os papéis orientados para negócios podem aproveitar esses recursos para refinar as ofertas de API, definir estratégias de precificação e criar listagens de produtos abrangentes que atraiam os consumidores de API.
Ao aproveitar o Amplify Marketplace, você pode converter suas APIs em ativos valiosos que são acessíveis e atraentes para os usuários. Essa abordagem não apenas promove uma adoção mais ampla, mas também aprimora seu fluxo de trabalho de desenvolvimento ao fornecer uma plataforma unificada e eficaz para gestão e produtização de APIs.
5. Impulsione a adoção com uma experiência aprimorada para o desenvolvedor de API
Os marketplaces de API devem permitir que consumidores de API internos e externos se beneficiem de capacidades avançadas de pesquisa, permitindo-lhes navegar facilmente por definições detalhadas de API, especificações e documentação para encontrar exatamente o que precisam.
A adoção bem-sucedida de APIs depende de uma experiência de desenvolvedor fluida.
Algumas empresas acham valioso criar um ou mais marketplaces voltados para consumidores de API, sejam eles internos ou externos. Essa flexibilidade permite que você configure um marketplace interno para uso interno, facilitando o acesso às APIs entre departamentos, ou um marketplace externo onde a monetização pode ser um foco principal.
O Amplify Marketplace é projetado para agilizar seu processo de integração de APIs, aprimorando sua experiência geral e promovendo uma adoção bem-sucedida.
O recurso “Experimente Agora” fornece um ambiente de teste incorporado que suporta OAuth2.0, permitindo testes rápidos e seguros das APIs. O feedback dos usuários é coletado por meio de classificações e avaliações, o que ajuda a melhorar continuamente as ofertas de API.
Para simplificar o processo de inscrição, oferecemos opções de login social com credenciais do Google, GitHub ou GitLab. A integração de faturamento com sistemas como Stripe garante uma experiência de monetização suave, tornando o pagamento e a coleta de receitas sem esforço.
Um exemplo de marketplace customizado.
6. Ofereça aos desenvolvedores insights valiosos — tanto para consumidores quanto para provedores de API
A visibilidade sobre o uso e o desempenho de APIs é essencial para tomar decisões informadas.
Métricas de desempenho empresarial e técnico são importantes para medir com precisão o ROI. E garantir alinhamento sobre como o sucesso de uma API será determinado é crucial para garantir que as APIs estejam sendo desenvolvidas corretamente para atender aos objetivos de uma organização.
O Amplify Marketplace oferece um painel de Insights Empresariais robusto que fornece dados acionáveis. Para os consumidores de API, o painel oferece acesso seguro e autônomo a métricas de uso, permitindo que os usuários otimizem suas interações com as APIs.
Para os provedores de API, as métricas de engajamento oferecem insights valiosos sobre a saúde do seu programa de API, enquanto o painel de assinaturas rastreia como diferentes equipes de consumidores utilizam suas assinaturas de API, garantindo uma governança eficaz. Esses insights permitem que você refine sua estratégia de API, aprimorando tanto a segurança quanto à adoção.
Uma visualização do dashboard pela perspectiva do provedor de API.
Revolucione sua experiência de desenvolvedor de API com o Amplify Enterprise Marketplace da Axway
Todas as APIs do mundo não podem fazer diferença se permanecerem não utilizadas. É uma das razões pelas quais uma experiência de desenvolvedor mais fluida tem um impacto tão grande no sucesso do programa de API de uma empresa.
O Amplify Enterprise Marketplace acelera a entrega de iniciativas digitais e impulsiona o valor da API, permitindo que os desenvolvedores encontrem e usem facilmente produtos de API comprovados, validados, totalmente documentados e prontos para produção.
Ao aprimorar sua experiência de desenvolvedor de API, você reduzirá a barreira de entrada para produzir e consumir suas iniciativas digitais de negócios.
Autores:
Jarno Verrijzer
Arquiteto de pré-vendasLydia Defranchi
Editora de conteúdo e blog da Axway
