API REST TERCERA PARTE: RECURSOS Y REPRESENTACION DE RECURSOS

Un recurso es la principal abstracción de información en una aplicación API, dicha abstracción de información u objeto utiliza un identificador de recurso único que se encuentra implícito en la URL y con la cual podemos acceder a la representación del recurso.

Acceso a la representación de un recurso

Utilizando el navegador a través de una URL como la siguiente https://rickandmortyapi.com/api/character, podemos acceder a todos los personajes de la serie «Rick y Morty» utilizando el identificador de recurso único «character» a continuación verás un resumen del payload o carga útil que es la respuesta enviada por la API la cual se encuentra en formato JSON.

{
  "info": {
    "count": 826,
    "pages": 42,
    "next": "https://rickandmortyapi.com/api/character/?page=2",
    "prev": null
  },
  "results": [
    {
      "id": 1,
      "name": "Rick Sanchez",
      "status": "Alive",
      "species": "Human",
      "type": "",
      "gender": "Male",
      "origin": {
        "name": "Earth",
        "url": "https://rickandmortyapi.com/api/location/1"
      },
      "location": {
        "name": "Earth",
        "url": "https://rickandmortyapi.com/api/location/20"
      },
      "image": "https://rickandmortyapi.com/api/character/avatar/1.jpeg",
      "episode": [
        "https://rickandmortyapi.com/api/episode/1",
        "https://rickandmortyapi.com/api/episode/2",
        // ...
      ],
      "url": "https://rickandmortyapi.com/api/character/1",
      "created": "2017-11-04T18:48:46.250Z"
    },
    // ...
  ]
}

Como puedes ver, no accedemos directamente al recurso, sino a un estado de una representación del recurso en un determinado momento. El recurso como tal esta almacenado en una base de datos, así que no existe un acceso directo hacia el recurso, por lo tanto, siempre que realizamos operaciones en una API REST se debe hacer a través de una transferencia de estado representacional de aquí el nombre de REST.

Deja un comentario