¿Que significa: 'api-rest'?

API REST (Interfaz de Programación de Aplicaciones de Transferencia de Estado Representacional)

Definición: Una API REST es un conjunto de reglas que permite a diferentes programas de software comunicarse entre sí en la web. API significa "Application Programming Interface" o "Interfaz de Programación de Aplicaciones", y REST significa "Representational State Transfer" o "Transferencia de Estado Representacional".

Concepto Simple: Imagina que quieres pedir comida en un restaurante. El menú es la API y muestra qué comidas puedes pedir (especifica lo que puedes hacer). REST es como las reglas del restaurante que dicen cómo debes pedir la comida (describe cómo deberías interactuar). Juntos, te permiten pedir comida fácilmente.

Componentes Básicos:

1. Recursos:

   • Los recursos son datos que deseas acceder o manipular (como información de usuarios, productos, etc.).
   • Cada recurso tiene una URL única que funciona como la dirección de una casa.

2. Métodos HTTP:

   • GET: Para leer información. Es como abrir una página web.
   • POST: Para crear algo nuevo, como mandar un formulario con tus datos.
   • PUT: Para actualizar información existente, como cambiar tu dirección en una cuenta online.
   • DELETE: Para borrar información, como eliminar una cuenta.
   • PATCH: Para hacer actualizaciones parciales.

3. Formato de Datos:

   • Principalmente usa JSON (JavaScript Object Notation), que es un formato fácil de leer y escribir para humanos y también fácil de interpretar y generar para las máquinas.

4. Stateless (Sin Estado):

   • Cada solicitud que haces a la API no depende de ninguna solicitud anterior. Es como si cada vez que hablas con el mesero del restaurante, le dices todo desde el principio nuevamente (por ejemplo, que eres alérgico a los cacahuates cada vez que pides algo).

Ventajas de API REST:

• Interoperabilidad: Diferentes sistemas y lenguajes de programación pueden trabajar juntos.
• Escalabilidad: Permite manejar muchas solicitudes simultáneamente sin problemas.
• Estandarización: Sigue unas reglas claras y definidas, lo que facilita su uso y entendimiento.

Uso Común:

• Aplicaciones móviles que necesitan conectarse a servidores para obtener datos.
• Servicios web que deben comunicarse entre sí.
• Integraciones entre diferentes sistemas o plataformas.

Ejemplo Práctico: Si tienes una aplicación de clima en tu teléfono, esta podría usar una API REST para buscar información del clima en un servidor. Cuando abres la app, esta envía una solicitud GET a la API para obtener los datos del clima en tu ciudad, y el servidor responde con los datos en formato JSON.

En resumen, una API REST es como un camarero en un restaurante, siguiendo reglas claras para tomar tu pedido y llevarlo a la cocina (servidor) y regresar con tu comida (datos). Esto facilita la comunicación entre diferentes programas en la web de manera efectiva y organizada.