El documento habla sobre cómo organizar proyectos de WebApi más allá de los ejemplos básicos "Hola Mundo". Aborda temas como inyección de dependencias, autenticación y autorización, documentación del API, versionado, pruebas unitarias e integración y más. Proporciona enlaces a repositorios de GitHub con ejemplos de implementación de estas técnicas.

2. WebApi,
más allá del “Hola
mundo”
19/10/2017

3. Hugo Biarge
Development Advisor at Plain Concepts
hbiarge@plainconcepts.com
@hbiarge

4. www.plainconcepts.com
MADRID
Paseo de la Castellana 163, 10º
28046 Madrid
T. (+34) 91 5346 836
BILBAO
Ledesma 10-bis, Planta 3 dpto 2
48001 Bilbao
T. (+34) 94 6073 371
BARCELONA
Av. Josep Tarradellas 10, 6º 1ª
08029 Barcelona
T. (+34) 93 3607 114
SEVILLA
Avenida de la innovación s/n
Edificio Renta Sevilla, 3º A
41020 Sevilla
DUBAI
Dubai Internet City. Building 1
73030 Dubai. EAU
T. (+971) 4 551 6653
LONDON
Impact Hub Kings Cross
24B York Way, N1 9AB
London. UK
SEATTLE
1511, Third Ave
Seattle WA 98101. USA
T. (+1) 206 708 1285

5. Agenda
Organización de proyectos
Inyección de dependencias
Autenticación y autorización
Documentación del api
Versionado
Implementación de los métodos de acción (CQRS)
Test de integración y unitarios
https://github.com/hbiarge/WebApi-Sample

7. Organización de proyectos
Api como proyecto de librería de clases
• Reutilizable en múltiples hosts
• Perdemos tooling 

8. Inyección de dependencias
DependencyResolvers
• Elige tu contenedor de IoC
Conoce la raíz de composición de WebApi
Cómo gestiona IDisposable tu contenedor?
Piensa en el ciclo de vida de tus dependencias

9. Autenticación y autorización
Diferencia entre 401 y 403
• Sobrescribe la implementación por defecto
ClaimsPrincipal tiene más información que los roles
• Utiliza los claims que necesites para tomar decisiones sobre autorización
https://github.com/DavidParks8/Owin-Authorization

10. Documenta tu API
Swagger
• Estandar de facto
Gran ecosistema
• Genaradores de código para clientes (C#, TypeScript, JS, …)
https://github.com/domaindrivendev/Swashbuckle

11. Versiona tu API
Permite evolucionar más fácilmente un API pública con clientes
Diferentes estrategias
• Url/query string
• Media Type
https://github.com/Microsoft/aspnet-api-versioning

12. Implementación de los métodos de acción
Separación de lecturas y escrituras
• CQRS
Comands and queries
• Micro-ORM en las queries
• DDD en los comandos
MediatR
• Bus en memoria
https://github.com/jbogard/MediatR

13. Testea tu API
Muy fácil montar integración
• TestServer de Owin
• TestServer es un host más de tu API
• End-2-End con base de datos
Haz test unitarios donde corresponda
• No pruebes la infraestructura
• Prueba la lógica

14. Thanks!
Hugo Biarge
hbiarge@plainconcepts.com
@hbiarge

15. www.plainconcepts.com
MADRID
Paseo de la Castellana 163, 10º
28046 Madrid
T. (+34) 91 5346 836
BILBAO
Ledesma 10-bis, Planta 3 dpto 2
48001 Bilbao
T. (+34) 94 6073 371
BARCELONA
Av. Josep Tarradellas 10, 6º 1ª
08029 Barcelona
T. (+34) 93 3607 114
SEVILLA
Avenida de la innovación s/n
Edificio Renta Sevilla, 3º A
41020 Sevilla
DUBAI
Dubai Internet City. Building 1
73030 Dubai. EAU
T. (+971) 4 551 6653
LONDON
Impact Hub Kings Cross
24B York Way, N1 9AB
London. UK
SEATTLE
1511, Third Ave
Seattle WA 98101. USA
T. (+1) 206 708 1285