API REST

• ¿QUÉ ES UNA API?

Significa "Application Programming Interface", es un software que hace de intermediario entre dos aplicaciones, teniendo así un conjunto de reglas que nos permite la comunicación.
En contraste con la interfaz de usuario la cual conecta a una persona con la computadora, las APIs conectan computadoras o piezas de software entre ellas.

Las APIs estan constituidas de diferentes partes que actuan como herramientas o servicios que estan al alcance del programador. Cuando un programador usa estas partes se dice que "llama" (call) a esa porción de la API. Estas llamadas son tambien conocidas como subrutinas, requests o endpoints.

Por ejemplo si tenemos una aplicación web con su información almacenada en un servidor, la forma de acceder a los datos es por medio de una API. El servidor realizará la consulta a la base de datos y por medio de la API la información llegara a la aplicación.
La API funciona como una "fachada" para el cliente (software que quiere utilizar nuestras API) ya que solo exponen acciones sensillas, aunque por detras se esten realizando cosas muy complejas.

Entonces, las API's de servicios web nos permiten el intercambio de información entre un servidor y un cliente, la comunicación se hará utizando el protocolo HTTP o HTTPS los datos normalmente son transportandos en formato JSON o XML

ENDPOINT

Es un final de un canal de comunicación, es decir que cuando dos APIs interactuan entre si el punto de contacto entre ambas es lo que se denomina endpoint. Son las locaciones donde cada API puede acceder a los recursos que necesita para realizar sus funciones.

El lugar donde las APIs mandan requests y donde estan los recursos de la misma, son los endpoints. Puntos de entrada y salida de activos e informacion.

HTTP

Hypertext Transfer Protocol

Protocolo (conjunto de reglas) diseñado para la transferencia de información entre dispositivos que trabajan conectados en red. En definitiva, es lo que nos permite navegar en la web por medio de direcciones.

HTTP sigue el clásico "cliente-servidor modelo", en donde un cliente abre una conección haciendo una request, luego espera a recibir la respuesta por parte del servidor.

Métodos básicos de HTTP: POST, GET, PUT, PATCH y DELETE

REST

REST es un tipo de API (es un servicio web), nos habla de un conjunto de reglas y estándares sobre como construir una API.
Es decir es decir es una aplicacion del lado del backend que se engarga de la comunicación con la base de datos, lógica, etc. Dicha aplicación puede ser utilizada por medio del protococolo HTTP por cualquier tipo de cliente.

Entonces vamos a tener diferentes métodos en los controladores de nuestra API REST y para cada uno de ellos vamos a tener definida una ruta (url) especifica y cada una de esas rutas tendra un método HTTP diferente

En conclusión:

REST simplemente es un principio sobre como usar las URLs (para la transferencia de datos) y el protocolo HTTP para estructurar una API.