API REST

REST (Representational State Transfer) es una arquitectura para diseñar APIs que permiten la comunicación entre sistemas mediante protocolos web, principalmente HTTP.

Su objetivo es que los recursos de un servidor (datos, servicios, objetos) puedan ser consultados y manipulados de manera sencilla y estandarizada.

Características

• Stateless (sin estado): Cada solicitud del cliente al servidor debe contener toda la información necesaria. El servidor no guarda el estado entre solicitudes.
• Recursos identificables mediante URIs: Cada recurso tiene su propia dirección (URL).
• Uso de métodos HTTP:
  • GET → Obtener datos
  • POST → Crear datos
  • PUT → Actualizar datos
  • DELETE → Eliminar datos
• Formatos de intercambio: Normalmente JSON, aunque también puede usarse XML u otros.
• Escalabilidad y simplicidad: Gracias a su estructura uniforme, es fácil mantener y ampliar APIs REST.

Endpoints

Un endpoint es la URL o dirección específica de un recurso en una API REST a la que se puede acceder mediante solicitudes HTTP. Cada endpoint representa un recurso concreto y permite ejecutar operaciones sobre él, como consultar, crear, actualizar o eliminar datos.

Ejemplo:

• GET /usuarios → Obtener la lista de usuarios.
• POST /usuarios → Crear un nuevo usuario.
• PUT /usuarios/1 → Actualizar el usuario con ID 1.
• DELETE /usuarios/1 → Eliminar el usuario con ID 1.