Uma aplicação, múltiplos clientes

Os desafios de uma aplicação que precisa ser consumida de diversas formas

Transcript

1. Uma aplicação, múltiplos clientes Os desafios de uma aplicação que precisa ser consumida de diversas formas
2. Jonathan Duarte Programador Ruby @jonduarte jonathanduarte.com.br
3. Assinatura Eletrônica de Documentos
4. Ecossistema Core API Wrappers Web / Mobile API Widget Embedded
5. Desafios encontrados • Controle de código • Atualização • Versionamento • Comunicação com clientes • Adaptação de novos devs • Testes • Disponibilização
6. Primeira abordagem
8. API • Não use versionamento no header • Configuração ideal é consumir sua api pelo navegador • Possibilite uma transição suave entre as versões
9. Documentação • Detalhe o máximo possível e crie TL;DR • Busque feedback com seus clientes (você pode não enxergar melhorias claras) • Para cada request, disponibilize qual é status code de sucesso e erro • Siga a spec HTTP sobre status code • Não deixe exceptions subir até o seu cliente final • Disponibilize códigos reais de exemplos
10. API Wrappers • Reduzem o seu trabalho • Mantenha versões para as principais linguagens de programação • Disponibilize-o em package managers • Simplicidade e flexibilidade é o principal objetivo
11. Usuários • Comunicação constante • Skype, E-mail, Sala pública do hipchat, etc • Seja transparente • Trabalhe juntos para encontrar a solução • Fazer a vida dele mais fácil, facilitará a sua
12. Widget • Interface antes do código • Use o que você já criou (API) • Iframe ao invés de manipulação de DOM
13. Testes • Testes de integração • Aplicações internas consumindo os serviços • QA
14. Resultados finais • Redução do core (mais remoções de código ao invés de adições) • Componentização das funcionalidades principais • Simplificação da arquitetura
15. Agradecimentos Rafael Masoni @rmasoni Daniel Libanori @dlibanori Pela ajuda com os slides
16. Obrigado @jonduarte jonathanduarte.com.br