REST y ROA introducción

INTRODUCCIÓN A REST Y ROA
(Resource Oriented Architecture)

¿Quién es este friki?
Twitter: @elafo
Github: eLafo

HTTP
● Protocolo de envío de mensajes en la web
● El cliente envía una petición (request)
● El servidor devuelve una respuesta(response)

Request
● Métodos
● Path
● Cabeceras
● Cuerpo

Ejemplos de request
POST /Earth/USA/Mount%20Rushmore HTTP/1.1
Host: maps.example.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
type=national-park&description=We%20visited%20on%203/5/2005

GET /index.html HTTP/1.1
Host: www.oreilly.com
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7.12)...
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,...
Accept-Language: us,en;q=0.5
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-15,utf-8;q=0.7,*;q=0.7
Keep-Alive: 300
Connection: keep-alive

Clasificación de métodos
● Métodos seguros
● Métodos idempotentes

Listado de métodos
● GET
● PUT
● DELETE
● POST
● HEAD
● OPTIONS
● TRACE
● CONNECT
● UPDATE

Response
● Código de respuesta
● Cabeceras
● Cuerpo

Ejemplo de response
HTTP/1.1 200 OK
Date: Fri, 17 Nov 2006 15:36:32 GMT
Server: Apache
Last-Modified: Fri, 17 Nov 2006 09:05:32 GMT
Etag: "7359b7-a7fa-455d8264
Accept-Ranges: bytes
Content-Length: 43302
Content-Type: text/html
X-Cache: MISS from www.oreilly.com
Keep-Alive: timeout=15, max=1000
Connection: Keep-Alive

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
...

●

¿Cómo se define un API?
● Qué hacer
– Método HTTP
– Path
– Cuerpo
● Sobre qué
– Path
– Cuerpo

Tipos de APIs
● RPC-Style
● REST
● REST-RPC Hybrid

Restful web services – Leonard Richardson &
Sam Ruby (O'reilly)

APIs RPC-STYLE
● Todo en el cuerpo
POST /rpc HTTP/1.1
Host: www.upcdatabase.com
User-Agent: XMLRPC::Client (Ruby 1.8.4)
Content-Type: text/xml; charset=utf-8
Content-Length: 158
Connection: keep-alive
<?xml version="1.0" ?>
<methodCall>
<methodName>lookupUPC</methodName>
...
</methodCall>

APIs REST
● Acción → Método HTTP
● Scope → Path

GET /hello.txt HTTP/1.1
Host: www.example.com

APIs REST-RPC Hybrid (aka REST
mis cojones 33)
● Todo en el path

GET services/rest?api_key=xxx&method=flickr.photos.search&tags=penguin
HTTP/1.1
Host: www.flickr.com

ROA (Resource Oriented
Architecture)
Orientado a recursos
(Nosotros decidimos qué es un recurso)

Architecture)
Cada recurso ha de tener al menos una URI
(addressability)
/release/20120511
/users/elafo

Truconsejo: mola que las URIs sean descriptivas
– /metal/iron_maiden vs /23slhdb/0238ghs

Architecture)
Un recurso puede tener varias URIs
Una URI sólo para un recurso
/release/20120511
/release/last

Aunque apunten a la misma información, el
concepto puede ser diferente

Architecture)
● Stateleness
– Cada petición debe resolverse de forma aislada
sin que afecten las anteriores

Architecture)
● Representaciones
– Idea vs bytes
– ¿Deberían todas las representaciones devolver la
misma información?

Architecture)
● Hypermedia
– Un recurso debería mostrar los recursos
relacionados por medio de URIs a dichos recursos

ROA(Resource Oriented
Architecture)
<?xml version='1.0' encoding='UTF-8'?>
<ListAllMyBucketsResult xmlns='http://s3.amazonaws.com/doc/2006-03-01/'>
<Owner>
<ID>c0363f7260f2f5fcf38d48039f4fb5cab21b060577817310be5170e7774aad70</ID>
<DisplayName>leonardr28</DisplayName>
</Owner>
<Buckets>
<Bucket>
<Name>crummy.com</Name>
<URI>https://s3.amazonaws.com/crummy.com</URI>
<CreationDate>2006-10-26T18:46:45.000Z</CreationDate>
</Bucket>
</Buckets>
</ListAllMyBucketsResult>

REST y ROA introducción

Recomendados

Recomendados

Más contenido relacionado

Similar a REST y ROA introducción

Similar a REST y ROA introducción (20)

Más de Javier Lafora Rey

Más de Javier Lafora Rey (8)

Último

Último (13)

REST y ROA introducción