Rest

Acciones CRUD en REST API

En el contexto de una API REST, CRUD se refiere a las operaciones Crear, Leer, Actualizar y Eliminar, que corresponden a métodos HTTP. A continuación, se explican cada una de estas acciones con ejemplos en formato JSON.

1. Crear (Create) - Método POST

La acción de Crear utiliza el método HTTP POST para enviar datos a la API y crear un nuevo recurso. Por ejemplo, para agregar un nuevo usuario, se envían los datos en el cuerpo de la solicitud:

POST /api/usuarios
Content-Type: application/json

{
    "nombre": "Juan Perez",
    "edad": 30,
    "email": "juan.perez@example.com"
}
    

Este ejemplo crea un nuevo usuario enviando un objeto JSON al endpoint /api/usuarios.

2. Leer (Read) - Método GET

La acción de Leer utiliza el método HTTP GET para recuperar información de la API. Por ejemplo, para obtener la información del usuario con id igual a 1:

GET /api/usuarios/1
    

Este ejemplo envía una solicitud GET al endpoint /api/usuarios/1 para obtener los datos del usuario con ID 1.

3. Actualizar (Update) - Método PUT o PATCH

La acción de Actualizar se realiza generalmente con el método HTTP PUT (para actualizar todos los datos) o PATCH (para actualizar solo algunos campos). Por ejemplo, para cambiar la edad del usuario con id igual a 1:

PUT /api/usuarios/1
Content-Type: application/json

{
    "nombre": "Juan Perez",
    "edad": 31,
    "email": "juan.perez@example.com"
}
    

En este ejemplo, se envía una solicitud PUT al endpoint /api/usuarios/1 para actualizar la información completa del usuario con ID 1.

4. Eliminar (Delete) - Método DELETE

La acción de Eliminar utiliza el método HTTP DELETE para borrar un recurso específico. Por ejemplo, para eliminar al usuario con id igual a 1:

DELETE /api/usuarios/1
    

Este ejemplo envía una solicitud DELETE al endpoint /api/usuarios/1 para eliminar el usuario con ID 1.

Estas operaciones CRUD en una API REST permiten manejar recursos a través de métodos HTTP estándar de manera simple y eficiente.