Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Sua API é uma User Interface

Sua API é uma User Interface

Palestra apresentada na Python Brasil 12 - Florianópolis por Renato Oliveira
User interface é "o espaço onde a interação entre humanos e máquinas ocorre. O objetivo desta interação é a operação e controle efetivos da máquina no lado do usuário e o feedback da máquina, que auxilia o operador na tomada de decisões operacionais."

Ter a ideia clara de quem é seu usuário e prover uma boa experiência para ele já é bastante trabalhado em interfaces gráficas. Técnicas e processos são aplicados para criar uma fomar simples e intuitiva de usar o produto/serviço. Mas quando a interface de interação é o código, como melhorar a experiência?

Nessa palestra pretendo falar um pouco de usabilidade sob a visão de um desenvolvedor e mostrar técnicas e protocolos para melhorar APIs web.

9c551fb4d374217cabb9a1ece02202b3?s=128

Labcodes Software Studio

October 25, 2016
Tweet

Transcript

  1. Renato Oliveira SUA API É UMA USER INTERFACE

  2. Quem sou eu Recife-PE Co-fundador e Developer na Labcodes Membro

    do PUG-PE DSF Comunidade <3
  3. Labcodes Software studio de Recife para o mundo Tecnologias que

    trabalhamos Labcodes e Comunidade Labcodes
  4. Disclaimer

  5. None
  6. Sua API é uma User Interface

  7. Sua API é uma User Interface

  8. Sua API é uma User Interface

  9. API Design

  10. Existem pessoas do outro lado!

  11. Existem usuários do outro lado!

  12. Em que devemos focar? Funcionalidade Usabilidade

  13. USER EXPERIENCE

  14. DEVELOPER EXPERIENCE

  15. UX Honeycomb usable useful valuable desirable accessible credible findable

  16. Como medir a usabilidade da sua API? Média de chamadas

    Estrutura Navegação Stack de desenvolvimento Tempo de Primeira chamada Tratamento de Erros
  17. “Ux sem pesquisa de usuário não é UX“

  18. Pesquisa de usuário Entrevistas Design Participativo Persona development

  19. Testes Escreva código cliente / wrapper Observe Coletar dados /

    Métricas
  20. Documentação Mostrar como começar a usar sua API Mostrar exemplos

    de como implementar casos de uso Sandbox
  21. Tratar Erros Diferentes tipos de Exceções Mensagens de Erro “Errors

    should never pass silently. Unless explicitly silenced”
  22. Abordagem top-down Primeiro pensar em como a API deve se

    comportar Prototipar Iterar Feedback
  23. Prototypar e iterar

  24. Design/Prototype Implementation Customer

  25. Design/Prototype Implementation Customer :D

  26. API Blueprint apiblueprint.org Ferramentas de mock Suíte de testes

  27. Empatia Entender Tente se por no lugar dos seus usuários

    De todos os seus usuários
  28. Funcionalidades são eternas Eternas enquanto dure a versão da sua

    API Não quebre clientes removendo funcionalidades da sua API Usuários só leem documentação uma vez
  29. “APIs are starting to look more like the product and

    less like the technology.” Jason Harmon, Diretor de API Design @ PayPal
  30. Obrigado! twitter.com/_renatoOliveira github.com/renatoliveira www.labcodes.com.br speakerdeck.com/labcodes

  31. None