En esta sesión se explican rápidamente algunos conceptos detras de APIs y REST, para pasar a una discusión sobre las mejores prácticas en el diseño, implementación y operación de APIs RESTful, sin perder de vista porque tiene que estar alineado con el modelo de negocio de la empresa. Conferencia que impartí durante SGCE2011

1. APIsMejores Prácticas Arturo Garrido

2. #SGCE2011 #I<3APIS

3. REST URL HTTP NOUN VERB

4. KEY POINTS Idempotency Self-documenting RESTfulness Versioning Statefulness Security Error Codes

5. IDEMPOTENCY Idempotence is the property of certain operations that they can be applied multiple times without changing the result. Request failures happen. Provide users a safe way to retry requests POST /BankAccount/AddFunds {‘value’: 1000, ‘token’: ‘TX123’}

6. SELF DOCUMENTING GET /Users/ID123 GET /Users/ID123/Friends GET /Users/ID123/Photos

7. RESTfulness

8. versioning GET /api/v1/blag GET /api/20101206/blag

9. statefulness POST /Calls GET /Calls/CA123 GET /Calls/CA123/Recordings/RE123

10. security

11. Response / ERROR CODES

12. Response / ERROR CODES

13. Response / ERROR CODES

14. Build it and they will come Documentation Easy to learn & use Hard to misue Support Engage

15. Arturo Garrido @arturogarrido arturo.garrido@gmail.com http://twitea.me http://www.shoutatweet.com http://emprende.la