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.

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
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