API Driven Developement

GitHub, Twitter, Facebook, Google – wszyscy mają WebAPI. Takie podejście to nie tylko możliwość współpracy z zewnętrznymi systemami, ale również lepsze bezpieczeństwo, mniej błędów i czysta architektura. W prezentacji pokażę dlaczego warto stworzyć API już na początku projektu. Opowiem o tym jak podejść do projektowania, implementacji i dokumentowania. Prezentacje sponsorują skróciki: REST, JAX-RS, Jackson/JAXB, OAuth, Restlet, NoSQL.

Transcript

1. API Driven Developement Grzegorz Godlewski
3. 3 Api Driven Developement O czym będzie? • RESTful API • Dlaczego warto udostępniać API? • Konstruowanie • Udostępnianie
4. 4 Amazon API Organizacja • All teams will expose their data and functionality through service interfaces. • Teams must communicate with each other through these interfaces. • There will be no other form of inter-process communication allowed. The only communication allowed is via service interface calls over the network. • It doesn’t matter what technology they use. • All service interfaces, without exception, must be designed from the ground up to be externalizable. No exceptions. Anyone who doesn’t do this will be fired. Thank you; have a nice day!
5. 5 Struktura systemu
6. 6 System oparty o API
7. 7 Wpływ API na system /post/1?commentOffset=100 /post/1?commentPage=2 Blog post Comment 0 Comment 1 Comment 500 Comment 0 Comment 1 Comment 500 Blog post Comment 0 - 49 Blog post Comment 50 - 99 Comment 100 - 149
8. 8 Richardson Maturity Model Level 0: Swamp of POX
9. 9 Richardson Maturity Model Level 0: Swamp of POX
10. 10 Richardson Maturity Model Level 1: Resources
11. 11 Richardson Maturity Model Level 2: HTTP Verbs - CRUD
12. 12 Richardson Maturity Model Level 3: HATEOAS - Hypermedia as the Engine of Application State
13. 13 Richardson Maturity Model Level 3: HATEOAS - Hypermedia as the Engine of Application State
14. 14 Reprezentacje XML - JAXB
15. 15 Reprezentacje JSON - Jackson
16. 16 Richardson Maturity Model JSON HAL - stateless.co/hal_specification.html
17. 17 Zasoby JAX-RS
18. 18 Kolejki Wywołanie asynchroniczne
19. 19 Restlet Budowa
20. 20 Skalowalność Sesje
21. 21 Bezpieczeństwo Tokeny
22. 22 Bezpieczeństwo OAuth 2.0
23. 23 Bezpieczeństwo OAuth 2.0
24. 24 REST inne HTTP • Statusy – 201, 202; 400, 405, 4xx..., 5xx • Przekierowania – 302, 303, 307; • Media Types • Cache – wygasanie, zasoby złożone • Transakcje
25. 25 Dokumentacja WADL
26. 26 Dokumentacja Swagger
27. 27 Dokumentacja Swagger
28. 28 Dokumentacja Swagger
29. 29 Dokumentacja apiary.io
30. 30 Inne opcje 3scale.net, mashape.com, mashery.com
31. 31 • Projektowanie • RESTful • Responsive API • Bezpieczeństwo • Udostęnienie developerom • Wersjonowanie, przestarzałe funkcje • Realny świat, realne API Podsumowanie Na co zwrócić uwagę tworząc API?
32. 32 grzegorz@godlewski.it http://gitgis.com - born to code Dziękuje za uwagę http://gitgis.com - born to code