URIs (Unique Resource Identifier)

La URL o URL es una dirección única que está asociada a un recurso en particular, el formato de las URIs es también definido de manera concertada entre el cliente y el servidor y ambos están al tanto de su formato.

http://www.mygame.com:8080/some/path?a=x&b=y

PROTOCOL

PORT

QUERY

DOMAIN

RESOURCE

https://www.mijuego.com/jugadores/rs221

Otra forma de enviar la identificación única de un recurso es a través de la sintaxis de parámetros de url. Sin embargo esta resulta menos conveniente ya que su funcionalidad no queda expuesta motores de búsqueda y generan diseños más difíciles de comprender para los desarrolladores.

https://www.mijuego.com/jugadores?id=rs221

Mensajes

Para interactuar con los recursos debemos utilizar mensajes; estos mensajes se apoyan fuertemente en la definición del protocolo http y sus verbos.

GET: Obtiene el valor de un recurso.
POST: Crea un recurso.
PUT: Actualiza o efectúa una operación que modifica un recurso.
DELETE: Elimina un recurso.

HEAD: A diferencia del GET, devuelve solo el header del recurso.

HTTP - GET

Permite recuperar el contenido de un recurso, usualmente lleva toda la información en la url ya que no suele contener datos privados o complejos de procesar.
Es el verbo más común, cuando una página web es cargada, el browser hace un request tipo GET al servidor que la almacena; este request contiene la URI del recurso así como cualquier parámetro opcional que se necesite.

HTTP - POST

Modifica el valor de un recurso, generalmente se utiliza para efectuar cualquier operación con el servidor que no sea recuperar.
Lleva los datos en el body del request utilizando algún formato acordado con el servidor (por ejemplo JSON) que es fácil de parsear e interpretar para efectuar la operación solicitada con los datos enviados.

Operaciones seguras

No importa cuantas veces se efectúe un GET, el valor que este devuelve no debe cambiar a menos que el recurso en sí haya cambiado.
Un POST se puede efectuar cuantas veces se quiera y el resultado será “idempotente”, es decir que tendrá la misma estructura que el recurso inicial y permitirá seguir operando con este normalmente.