Teste suas interfaces (APIs)

Cada empresa de software que se preze faz testes de usabilidade atualmente. Claro que sim, de que outra forma conseguiremos dados concretos sobre o bom funcionamento de nossas interfaces de usuário?

Mas em vez de apenas testar “usuários finais”, por exemplo, as pessoas que usam nossos produtos, recentemente iniciamos um tipo diferente de teste de interface. Nossas interfaces de programação (APIs) também têm usuários! Quem somos nós para não testá-los também? Se você estiver na posição de escrever uma API que outra pessoa (dentro ou fora da sua empresa) precise usar, considere este processo:

  1. Pense nos possíveis usos e projete a estrutura de sua API de acordo.
  2. Implemente uma amostra dele, sem comentários no código-fonte.
  3. Chame um colega à sua mesa e peça-lhe que o examine. Não diga nada a ele, apenas que ele tem que pensar em voz alta para que você possa observar o quão bem ele entende suas intenções com a API.
  4. Melhore com base em suas observações e comece uma nova iteração.

É assim que fazemos, e achamos que isso nos ajudou a tornar APIs mais compreensíveis e simplesmente melhores.