Slide 1

Slide 1 text

Renato Oliveira SUA API É UMA USER INTERFACE

Slide 2

Slide 2 text

Quem sou eu Recife-PE Co-fundador e Developer na Labcodes Membro do PUG-PE DSF Comunidade <3

Slide 3

Slide 3 text

Labcodes Software studio de Recife para o mundo Tecnologias que trabalhamos Labcodes e Comunidade Labcodes

Slide 4

Slide 4 text

Disclaimer

Slide 5

Slide 5 text

No content

Slide 6

Slide 6 text

Sua API é uma User Interface

Slide 7

Slide 7 text

Sua API é uma User Interface

Slide 8

Slide 8 text

Sua API é uma User Interface

Slide 9

Slide 9 text

API Design

Slide 10

Slide 10 text

Existem pessoas do outro lado!

Slide 11

Slide 11 text

Existem usuários do outro lado!

Slide 12

Slide 12 text

Em que devemos focar? Funcionalidade Usabilidade

Slide 13

Slide 13 text

USER EXPERIENCE

Slide 14

Slide 14 text

DEVELOPER EXPERIENCE

Slide 15

Slide 15 text

UX Honeycomb usable useful valuable desirable accessible credible findable

Slide 16

Slide 16 text

Como medir a usabilidade da sua API? Média de chamadas Estrutura Navegação Stack de desenvolvimento Tempo de Primeira chamada Tratamento de Erros

Slide 17

Slide 17 text

“Ux sem pesquisa de usuário não é UX“

Slide 18

Slide 18 text

Pesquisa de usuário Entrevistas Design Participativo Persona development

Slide 19

Slide 19 text

Testes Escreva código cliente / wrapper Observe Coletar dados / Métricas

Slide 20

Slide 20 text

Documentação Mostrar como começar a usar sua API Mostrar exemplos de como implementar casos de uso Sandbox

Slide 21

Slide 21 text

Tratar Erros Diferentes tipos de Exceções Mensagens de Erro “Errors should never pass silently. Unless explicitly silenced”

Slide 22

Slide 22 text

Abordagem top-down Primeiro pensar em como a API deve se comportar Prototipar Iterar Feedback

Slide 23

Slide 23 text

Prototypar e iterar

Slide 24

Slide 24 text

Design/Prototype Implementation Customer

Slide 25

Slide 25 text

Design/Prototype Implementation Customer :D

Slide 26

Slide 26 text

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

Slide 27

Slide 27 text

Empatia Entender Tente se por no lugar dos seus usuários De todos os seus usuários

Slide 28

Slide 28 text

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

Slide 29

Slide 29 text

“APIs are starting to look more like the product and less like the technology.” Jason Harmon, Diretor de API Design @ PayPal

Slide 30

Slide 30 text

Obrigado! twitter.com/_renatoOliveira github.com/renatoliveira www.labcodes.com.br speakerdeck.com/labcodes

Slide 31

Slide 31 text

No content