Como a abordagem API-first está moldando o futuro da Zonos

O que é uma abordagem API-first? 

A abordagem API-first contrasta fortemente com a abordagem code-first, na qual uma equipe começa projetando a funcionalidade da aplicação, escrevendo o código e, só então, adicionando as APIs ao final do processo.

Na Zonos, desenvolver software com uma abordagem API-first significa projetar soluções em torno de uma API, em vez de programar uma aplicação e adicionar uma API depois. Isso significa que nossas APIs são fundamentais e são produtos por si só; nós as projetamos com foco intenso nas necessidades do cliente, e as documentamos e arquitetamos claramente antes de escrever qualquer código.

Os benefícios de uma abordagem API-first 

A abordagem API-first ajuda a estabelecer a seguinte mentalidade:

• Entendemos que nossas APIs são a principal interface para nossos clientes e, por isso, as tratamos como nossos entregáveis públicos.
• Documentar antes de escrever o código nos dá a oportunidade de refletir, discutir, refinar e comunicar nossos objetivos às nossas equipes e partes interessadas, para criar um produto final melhor.
• Ao focarmos nas necessidades de nossos clientes, entendemos a melhor forma de projetar APIs que atendam a essas necessidades.

Essa mentalidade coloca nossas APIs e nossos clientes em primeiro lugar e é fundamental para estabelecer uma base em que todos na Zonos sejam responsáveis pelo sucesso do cliente.

As equipes de desenvolvimento podem trabalhar em paralelo

A abordagem API-first envolve o estabelecimento de um contrato. Criar um contrato entre serviços que é seguido por equipes em toda a organização permite que essas equipes trabalhem em várias APIs ao mesmo tempo. Os desenvolvedores não precisam esperar o lançamento de atualizações de uma API antes de avançar para a próxima. As equipes podem simular e testar APIs e suas dependências simultaneamente, com base em definições de API pré-estabelecidas.

Reduz o custo de desenvolvimento

APIs e código podem ser reutilizados em muitos projetos diferentes. Na abordagem API-first, se uma equipe de desenvolvimento quiser criar uma nova aplicação, ela não precisa começar do zero, o que economiza tempo e dinheiro. O design API-first também permite que a maioria dos problemas seja resolvida antes mesmo de qualquer código ser escrito, o que ajuda a evitar problemas na hora de integrar as APIs às aplicações.

Aumenta a velocidade de lançamento no mercado

Grande parte do processo de criação de APIs pode ser automatizada usando ferramentas para importar arquivos de definição de API. Começamos gerando os tipos, definições e esquemas principais; com esses arquivos, ferramentas de API como documentação, kits de desenvolvimento de software (SDKs) e APIs simuladas podem ser geradas automaticamente. A automação acelera significativamente o desenvolvimento de APIs e aplicações.

O API-first também torna possível adicionar novos serviços e tecnologias às aplicações sem a necessidade de reestruturar todo o sistema. A Zonos precisa lançar recursos em produção rapidamente para se manter competitiva no mercado de SaaS transfronteiriço, que está em constante mudança. É mais fácil eliminar dívida técnica no código subjacente do que migrar clientes de uma API mal projetada.

Garante boas experiências para os desenvolvedores

Os consumidores de APIs são, na maioria das vezes, desenvolvedores, e a experiência do desenvolvedor (DX) pode determinar o sucesso ou o fracasso de uma API. A abordagem API-first garante que a experiência do desenvolvedor seja positiva, porque uma API bem projetada, bem documentada e consistente é mais fácil de aprender e reutilizar. Isso também aumenta a velocidade de implementação. Todos esses benefícios estão interligados!

Aumenta o sucesso a longo prazo

Uma abordagem API-first permite prototipagem e iteração rápidas, o que significa que aprendemos mais rápido o que funciona e o que não funciona. Assim como as 1.000 tentativas frustradas de Edison antes de criar a lâmpada, API-first significa falhar rápido e seguir em frente com uma compreensão melhor de como alcançar o sucesso. O API-first aumenta nosso sucesso a longo prazo ao garantir que as APIs sejam confiáveis, consistentes e fáceis de usar para os desenvolvedores.

Por que trabalhar de trás para frente é eficaz? 

Em 2015, tive a oportunidade de redesenhar o site de e-commerce de uma marca de consumo popular. Avaliei vários indicadores-chave de desempenho (KPIs) relacionados ao sistema existente, e ficou claro onde as maiores melhorias poderiam ser feitas:

• A taxa de conversão no desktop estava abaixo do padrão.
• A taxa de conversão no mobile era péssima.
• A porcentagem de tráfego mobile estava aumentando rapidamente e ultrapassaria 50% do tráfego total nos próximos 12 meses. Por causa da péssima taxa de conversão no mobile, ter a maior parte do tráfego vindo do mobile não era o ideal.

Diante dos dados, o que criaria mais valor para os usuários? Era óbvio: corrigir os problemas na experiência do usuário mobile do site. Por isso, adotei uma abordagem mobile-first para redesenhar o site. Isso significava que todos os designs, a arquitetura, as APIs etc. consideravam primeiro a experiência mobile. Isso era o inverso da abordagem tradicional da época, que focava primeiro na experiência de desktop, muitas vezes deixando a experiência mobile como um complemento mal encaixado, com taxas de conversão ruins. A abordagem mobile-first também exigiu mais esforço desde o início — não foi o caminho mais fácil. Foi necessária uma nova arquitetura, novas APIs precisaram ser escritas, e vários designs foram necessários para cada breakpoint.

A abordagem mobile-first resultou em um aumento significativo na taxa de conversão mobile. A nova arquitetura também gerou ganhos impressionantes na taxa de conversão de desktop. A abordagem foi bem-sucedida porque identificou como criar o máximo de valor para o usuário e concentrou toda a estratégia em entregar esse valor. Ela criou a mentalidade certa desde o início. Da mesma forma — embora possa parecer um retrocesso — uma abordagem API-first cria oportunidades para identificar problemas mais amplos e, então, construir uma base para corrigi-los.

Qual é a responsabilidade da engenharia? 

A mentalidade API-first tem levado, e continuará levando, a Zonos ao sucesso, e a engenharia desempenha um papel essencial nisso. É nossa responsabilidade manter sempre a mentalidade API-first. Isso significa que estamos constantemente fazendo perguntas que mantêm o foco em nossas APIs, como: “Como nossas APIs podem atender às necessidades do cliente” Também significa que sempre respondemos a perguntas sobre recursos e funcionalidades com um link para nossa documentação de API. Se a documentação não existir, nós a criamos — trabalhando em conjunto em equipes multifuncionais para garantir que a Zonos tenha uma documentação de API excelente.