APIsMejores Prácticas<br />Arturo Garrido<br />
#SGCE2011<br />#I<3APIS<br />
REST<br />URL      HTTP<br />NOUN     VERB<br />
KEY POINTS<br />Idempotency<br />Self-documenting<br />RESTfulness<br />Versioning<br />Statefulness<br />Security<br />Er...
IDEMPOTENCY<br />Idempotence is the property of certain operations that they can be applied multiple times without changin...
SELF DOCUMENTING<br />GET /Users/ID123<br />GET /Users/ID123/Friends<br />GET /Users/ID123/Photos<br />
RESTfulness<br />
versioning<br />GET /api/v1/blag<br />GET /api/20101206/blag<br />
statefulness<br />POST /Calls<br />GET /Calls/CA123<br />GET /Calls/CA123/Recordings/RE123<br />
security<br />
Response / ERROR CODES<br />
Response / ERROR CODES<br />
Response / ERROR CODES<br />
Build it and they will come<br />Documentation<br />Easy to learn & use<br />Hard to misue<br />Support<br />Engage<br />
Arturo Garrido<br />@arturogarrido<br />arturo.garrido@gmail.com<br />http://twitea.me<br />http://www.shoutatweet.com<br ...
Upcoming SlideShare
Loading in...5
×

Mejores prácticas en el diseño e implementación de APIs

957

Published on

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

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
957
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
0
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "Mejores prácticas en el diseño e implementación de APIs "

  1. 1. APIsMejores Prácticas<br />Arturo Garrido<br />
  2. 2. #SGCE2011<br />#I<3APIS<br />
  3. 3. REST<br />URL HTTP<br />NOUN VERB<br />
  4. 4. KEY POINTS<br />Idempotency<br />Self-documenting<br />RESTfulness<br />Versioning<br />Statefulness<br />Security<br />Error Codes<br />
  5. 5. IDEMPOTENCY<br />Idempotence is the property of certain operations that they can be applied multiple times without changing the result.<br />Request failures happen. Provide users a safe way to retry requests<br />POST /BankAccount/AddFunds<br />{‘value’: 1000, ‘token’: ‘TX123’}<br />
  6. 6. SELF DOCUMENTING<br />GET /Users/ID123<br />GET /Users/ID123/Friends<br />GET /Users/ID123/Photos<br />
  7. 7. RESTfulness<br />
  8. 8. versioning<br />GET /api/v1/blag<br />GET /api/20101206/blag<br />
  9. 9. statefulness<br />POST /Calls<br />GET /Calls/CA123<br />GET /Calls/CA123/Recordings/RE123<br />
  10. 10. security<br />
  11. 11. Response / ERROR CODES<br />
  12. 12. Response / ERROR CODES<br />
  13. 13. Response / ERROR CODES<br />
  14. 14. Build it and they will come<br />Documentation<br />Easy to learn & use<br />Hard to misue<br />Support<br />Engage<br />
  15. 15. Arturo Garrido<br />@arturogarrido<br />arturo.garrido@gmail.com<br />http://twitea.me<br />http://www.shoutatweet.com<br />http://emprende.la<br />

×