Good neighbors make good games!

Principios de diseño de APIs REST
(desmitificando REST)
Enrique Amodeo
This book is for sale at http://leanpub.com/introduccion_apis_rest
This version was published on 2013-03-06
This is a Leanpub book. Leanpub empowers authors and publishers with the Lean Publishing
process. Lean Publishing is the act of publishing an in-progress ebook using lightweight tools and
many iterations to getreader feedback, pivot until you have the right book and build traction once
you do.

©2012 - 2013 Enrique Amodeo

Tweet This Book!
Please help Enrique Amodeo by spreading the word about this book on Twitter!
The suggested tweet for this book is:
Acabo de comprar ”Principios de Diseño de APIs REST” El libro de #REST en español #esrest
The suggested hashtag for this book is #esrest.Find out what other people are saying about the book by clicking on this link to search for this
hashtag on Twitter:
https://twitter.com/search/#esrest

Índice general
Sobre la cubierta

i

Agradecimientos

ii

Érase una vez…

iii

1

APIs orientadas a datos: CRUD

1

1.1

Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1

1.2Leyendo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2

1.3

Actualizando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

1.4

Borrando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

1.5

Creando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .

12

1.6

Seguramente CRUD no sea lo mejor para tu API… . . . . . . . . . . . . . . . . . . .

15

Sobre la cubierta
La foto de la cubierta es de un famoso trampantojo en la ciudad de Quebec, más concretamente en
el Quartier Petit Champlain.
El autor eligió esta foto como cubierta porque ilustra claramente un conjunto de agentes interoperando entre sí.

iAgradecimientos
Este libro empezó como un pequeño y corto capítulo en otro libro. Los que me conocen ya se temían
que ese pequeño capítulo no iba a ser tan pequeño. Debido a ello, y a problemas de calendario decidí
publicar el libro por separado y a mi ritmo. Gracias a ese equipo de personas por poner en marcha
esto y por sus sugerencias, en especial a @ydarias, @estebanm, y @carlosble.
Graciasa todos aquellos que me han ayudado a mover el libro por el mundo del “social media”.
Me gustaría agradecer a @pasku1 y a @juergas por sus esfuerzos como revisores de este libro (os
debo una caña… bueno dos). Sé que siempre puedo recurrir a ellos cuando me apetece calentarle la
cabeza a alguien con mi última idea.
Y como no podría ser de otra forma, un agradecimiento especial a mi mujer,@mcberros, por no
permitir nunca que dejara este proyecto y por su apoyo incondicional.

ii

Érase una vez…
Tras muchos años intentando crear servicios web basados en tecnologías RPC, tales como CORBA
o SOAP, la industria del desarrollo de software se encontraba en un punto muerto. Cierto, se había
conseguido el gran logro de que un servicio implementado en .NET consiguiera comunicarse conuno escrito en Java, o incluso con otro hecho a base de COBOL, sin embargo todo esto sabía a
poco. Es normal que supiera a poco, se había invertido cantidades ingentes de dinero en distintas
tecnologías, frameworks y herramientas, y las recompensas eran escasas. Lo peor es que además las
compañías se encontraban encalladas en varios problemas.
Por un lado la mantenibilidad de la base decódigo resultante era bastante baja. Se necesitaban
complejos IDEs para generar las inescrutables toneladas de código necesarias para interoperar.
Los desarrolladores tenían pesadillas con la posibilidad de que se descubriera algún bug en la
herramienta de turno, o de que algún parche en éstas destruyera la interoperabilidad. Y si se
necesitaba alguna versión o capacidad más avanzada de SOAP,...