FUNDAMENTOS
API REST
Impulsamos { talento }
Impulsamos { talento }
FUNDAMENTOS API REST
Impulsamos { talento }
¿Qué es una API?
API es la abreviatura de “Aplication Programming Interface” (Interfaz de Programación de
Aplicaciones). Es una “llave de acceso” a funciones que podemos utilizar de un servicio web
provisto por un tercero, dentro de nuestra propia aplicación web, de manera segura y
confiable.
Un buen ejemplo sería la API de themoviedb -> [Link]
Desde este enlace podemos acceder a todo el contenido de la base de datos de películas
themoviedb e interactuar con sus diversos endpoints (veremos qué es esto más adelante) para
consultar datos y traer la respuesta a esas consultas a nuestra aplicación.
Impulsamos { talento }
¿Qué es REST?
REST es la abreviatura de “Representational State Transfer” (Transferencia de Estado
Representacional). Es un estilo de arquitectura software para sistemas hipermedia
distribuidos como la World Wide Web.
El término se originó en el año 2000, en una tesis doctoral sobre la web escrita por Roy
Fielding, uno de los principales autores de la especificación del protocolo HTTP y ha
pasado a ser ampliamente utilizado por la comunidad de desarrollo.
Impulsamos { talento }
Cómo funciona
Impulsamos { talento }
Ejemplo de cómo funciona
Imagina a un camarero en un restaurante. Tú, el cliente, estás sentado en una mesa mirando un menú
con distintas opciones para pedir, siendo la cocina el proveedor que satisfacerá este pedido.
Necesitas una conexión para comunicar tu pedido a la cocina y que pueda ser procesado. ese link no
puede ser el chef porque está ocupado en la cocina. Necesitas algo que conecte al cliente que escoge
un plato con el cocinero que ha de prepararlo. Es ahí donde el camarero — o la API — entra en
acción.
El camarero toma nota de tu pedido, lo transmite a la cocina, especificando que ha de hacer. Entonces
trae la respuesta hacia ti, en este caso, se trataría de la comida. Hemos de tener en cuenta que si la
API se ha diseñado correctamente, ¡tu pedido no acabará por los suelos!
Impulsamos { talento }
Ejemplo de API REST
GET /users -> { code: 200, data: [{id:1, name:'juan'}, {id:0,
name:'Ivan'}]}
GET /users/1 -> {code:200, data: {id:1, name:'juan'}}
POST /users , body: {name:'Paco'} -> {code: 201}
DELETE /users/1 -> {code: 200}
GET /users -> { code: 200, data: [ {id:0, name:'Ivan'}, {name:'Paco',
id:2}]}
GET /users/1 -> {code:404}
Impulsamos { talento }
CRUD
Impulsamos { talento }
C.R.U.D (Create, Read, Update, Delete)
Utilizamos el estándar HTTP
● Post: Para crear un recurso
● Get: Para obtener recursos
● Put: Para modificar un recurso.
● Delete: Para eliminar un recurso.
Impulsamos { talento }
C.R.U.D (Read, Create, Update, Delete)
Impulsamos { talento }
ENDPOINTS
Impulsamos { talento }
EndPoints
Los objetos en REST siempre se manipulan a partir de la URI (EndPoints).
Impulsamos { talento }
JSON
Pues esto se lo debemos a Douglas Crockford, creador del
estándar JSON. JavaScript Object Notation.
Impulsamos { talento }
¿Cómo se envía el JSON?
Mediante una petición POST a un endpoint determinado y en pasando en el
body un json con la información que queremos registrar.
{
"provider":0,
"nickname": "xavi12",
"password": "jrodriguez"
}
Impulsamos { talento }
¿Cómo modificamos un elemento?
Mediante una petición PUT a un endpoint determinado y en pasando en el
body un json con la información que queremos modificar.
{
"provider":0,
"nickname": "xavi12",
"password": "jrodriguez"
}
Impulsamos { talento }
¿Cómo eliminamos un elemento?
Accediendo a una uri y utilizando DELETE para poder eliminar un elemento
en particular podemos pasar por la uri un parámetro que puede ser un id de
dicho elemento.
Impulsamos { talento }
Códigos HTTP
Dado que estamos sobre el protocolo http, también debemos devolver un
código HTTP.
● 1xx: Respuestas Informativas
● 2xx: Peticiones Correctas
● 3xx: Redirecciones
● 4xx: Errores del Cliente
● 5xx: Errores de Servidor
Códigos HTTP
![Impulsamos { talento }
Ejemplo de API REST
GET /users -> { code: 200, data: [{id:1, name:'juan'}, {id:0,
name:'Ivan'}]}](/p?url=https%3A%2F%2Fscreenshots.scribd.com%2FScribd%2F252_100_85%2F141%2F620263683%2F8.jpeg&__src=https%3A%2F%2Fes.scribd.com%2Fdocument%2F620263683%2F00-Fundamentos-API-REST&__type=image)
