¿Qué es una API REST?

Una API REST es una forma de diseñar una interfaz mediante la cual una aplicación puede comunicarse con otra utilizando principalmente el protocolo HTTP.

Por ejemplo, un frontend puede enviar una solicitud a un backend para consultar, crear, modificar o eliminar información.

Frontend
   -> HTTP ->
API REST
   ->
Backend / Base de datos

1. Recursos y URLs

Una API REST organiza la información como recursos, que normalmente se identifican mediante URLs.

Por ejemplo:

GET /usuarios
GET /usuarios/15

El primer endpoint puede representar una consulta de usuarios y el segundo un usuario específico.

2. Métodos HTTP

Las operaciones suelen expresarse mediante métodos HTTP:

GET: consultar información.
POST: crear información.
PUT: actualizar un recurso.
DELETE: eliminar un recurso.

3. Datos en la respuesta

Una API puede devolver información estructurada. JSON es un formato común para representar esos datos.

{
  "id": 15,
  "nombre": "Arturo"
}

Consideraciones

En términos simples, una API REST es una interfaz que permite que diferentes sistemas se comuniquen mediante solicitudes HTTP, utilizando recursos, URLs, métodos como GET, POST, PUT y DELETE, y respuestas con datos estructurados.