API Rest

Las APIs REST son uno de los componentes más importantes del desarrollo web moderno. Actualmente, prácticamente todas las aplicaciones web utilizan REST APIs para comunicarse con servidores y servicios externos.

Cuando una aplicación necesita obtener información desde una base de datos, autenticar usuarios, enviar formularios o actualizar contenido dinámicamente, normalmente lo hace mediante una REST API.

Las REST APIs permiten conectar:

• Frontend y backend,
• Aplicaciones móviles y servidores,
• Sitios web y servicios externos,
• Sistemas internos y plataformas online.

1. ¿Qué es una API REST?

Una REST API es un tipo de API diseñada para permitir la comunicación entre aplicaciones mediante internet utilizando HTTP.

REST significa:

Representational State Transfer

Aunque internamente utilizan HTTP, las REST APIs se enfocan principalmente en organizar y exponer datos de manera estructurada para que otras aplicaciones puedan utilizarlos fácilmente.

2. ¿Qué hace realmente una REST API?

La función principal de una REST API es actuar como intermediaria entre un cliente y los datos almacenados en un servidor (Modelo cliente – servidor).

Por ejemplo:

• Una tienda online obtiene productos desde una REST API,
• Una red social carga publicaciones desde una REST API,
• Una aplicación del clima obtiene información meteorológica desde una REST API.

En la mayoría de los casos, las REST APIs trabajan conectadas a:

• Bases de datos,
• Sistemas de autenticación,
• Servidores,
• Servicios externos,
• Plataformas cloud.

3. REST APIs alojadas en servidores

A diferencia de las Web APIs del navegador, las REST APIs normalmente se encuentran alojadas en servidores.

Eso significa que viven en un backend y pueden ser consumidas desde cualquier aplicación capaz de realizar solicitudes HTTP.

Por ejemplo:

https://api.example.com/usuariosLenguaje del código: JavaScript (javascript)

🚨Esa URL representa una REST API alojada en un servidor.

Cuando una aplicación accede a esa dirección, el servidor procesa la solicitud y devuelve información.

4. ¿Qué tipo de información devuelve?

Generalmente las REST APIs devuelven datos en formato JSON porque es liviano, fácil de leer y totalmente compatible con JavaScript.

Ejemplo:

[
  {
    "id": 1,
    "nombre": "Juan"
  },
  {
    "id": 2,
    "nombre": "Ana"
  }
]Lenguaje del código: JSON / JSON con comentarios (json)

Ese formato permite que aplicaciones frontend puedan mostrar información dinámicamente en pantalla.

5. Diferencia entre REST APIs y Web APIs

Aunque ambas forman parte del concepto general de API, cumplen funciones diferentes.

5.1. Web APIs

Las Web APIs son funcionalidades integradas en el navegador.

Ejemplos:

• Fetch API
• DOM API
• Geolocation API
• localStorage API

Estas APIs permiten interactuar con el navegador y el dispositivo del usuario.

5.2. REST APIs

Las REST APIs son servicios alojados en servidores y utilizados para intercambiar datos entre aplicaciones.

Por ejemplo:

fetch("https://api.example.com/usuarios")Lenguaje del código: JavaScript (javascript)

En este caso:

• fetch() pertenece a una Web API del navegador,
• Mientras que api.example.com corresponde a una REST API alojada en un servidor.

6. REST APIs y JavaScript moderno

Las REST APIs son fundamentales en JavaScript moderno porque permiten construir aplicaciones dinámicas y conectadas a datos reales.

Actualmente, frameworks y tecnologías como:

• React,
• Vue,
• Angular,
• Next.js,
• Node.js,

Trabajan constantemente consumiendo REST APIs.

Gracias a ellas, las aplicaciones pueden:

• Obtener datos en tiempo real,
• Autenticar usuarios,
• Actualizar contenido sin recargar la página,
• Conectarse con bases de datos,
• Interactuar con servicios externos.

7. Relación entre REST APIs y HTTP

Las REST APIs utilizan HTTP para funcionar.

Por eso conceptos como:

• Peticiones HTTP,
• Métodos GET y POST,
• Códigos de estado,
• Fetch API,
• Manejo de errores,

Están directamente relacionados con REST.

8. ¿Cómo consumir una API REST? Paso a paso

Consumir una API REST significa conectarse a un servidor para obtener, enviar o modificar información desde JavaScript.

Actualmente esto se realiza principalmente utilizando fetch(), que permite hacer solicitudes HTTP desde el navegador.

El proceso básico funciona así:

8.1. Tener la URL de la API

Primero se necesita la dirección del recurso que queremos consumir.

Ejemplo:

https://api.example.com/usuariosLenguaje del código: JavaScript (javascript)

8.2. Realizar la solicitud

JavaScript utiliza el método fetch() para conectarse a la API.

// Solicitud a la API
fetch("https://jsonplaceholder.typicode.com/users")Lenguaje del código: JavaScript (javascript)

8.3. Recibir la respuesta

La API devuelve información, normalmente en formato JSON.

[
  {
    "id": 1,
    "nombre": "Juan"
  }
]Lenguaje del código: JSON / JSON con comentarios (json)

8.4. Convertir los datos

La respuesta debe transformarse a JSON para poder utilizarla en JavaScript.

fetch("https://jsonplaceholder.typicode.com/users")
  .then(respuesta => respuesta.json())Lenguaje del código: JavaScript (javascript)

8.5. Utilizar la información

Finalmente, los datos pueden mostrarse en pantalla, almacenarse o manipularse dinámicamente.

fetch("https://jsonplaceholder.typicode.com/users")
  .then(respuesta => respuesta.json())
  .then(datos => {
    console.log(datos);
  });Lenguaje del código: JavaScript (javascript)

9. Ejemplo real de REST APIs

Algunos ejemplos muy conocidos de REST APIs son:

Servicio	Uso
API de GitHub	Repositorios y usuarios
API de Stripe	Pagos online
API de OpenWeather	Información climática
API de YouTube	Videos y canales
API de Spotify	Música y playlists

Todas estas APIs permiten que otras aplicaciones interactúen con sus servicios mediante internet.

10. Conclusión

Las REST APIs son servicios alojados en servidores que permiten la comunicación entre aplicaciones mediante HTTP y el intercambio de datos, generalmente en formato JSON.

Actualmente son una de las bases principales del desarrollo web moderno y resultan fundamentales para trabajar con JavaScript, aplicaciones frontend, backend y sistemas conectados a internet.