10. Endpoints PUT/PATCH y DELETE: Actualización Total/Parcial y Eliminación Limpia
Gestiona la actualización de recursos verificando existencia previa y la eliminación de registros respondiendo con HTTP 200 o 204 No Content.
Actualizaciones y Eliminaciones en REST
Para modificar o suprimir un recurso, la convención REST dicta que la URI debe contener el identificador único del recurso objetivo (por ejemplo: PUT /api/productos/14 o DELETE /api/productos/14).
El Flujo de Verificación Previa (Check Existence)
Antes de ejecutar un UPDATE o un DELETE, una API profesional verifica si el recurso existe:
- Si el ID no existe en la base de datos, responde de inmediato con
HTTP 404 Not Found. - Si existe, procede con la actualización y devuelve el objeto resultante con
HTTP 200 OK. - Para eliminaciones, se puede devolver
HTTP 200 OKcon un mensaje confirmatorio oHTTP 204 No Contentsin cuerpo de respuesta.
⚡ Controlador de Actualización Parcial (PATCH) y Eliminación (DELETE)
Implementación en PHP nativo para modificar dinámicamente campos enviados y borrar registros:
<?php
declare(strict_types=1);
final class ProductoControladorUpdateDelete
{
/**
* PATCH /api/productos/{id}
*/
public function actualizar(int $id): void
{
$db = Database::getConnection();
// 1. Comprobar que el producto exista
$check = $db->prepare('SELECT id FROM productos WHERE id = :id');
$check->execute(['id' => $id]);
if (!$check->fetch()) {
ApiResponse::error("Producto con ID $id no encontrado", 404);
}
$payload = json_decode(file_get_contents('php://input'), true) ?? [];
$camposPermitidos = ['nombre', 'precio', 'stock'];
$camposAActualizar = [];
$parametros = ['id' => $id];
// 2. Construir dinámicamente la sentencia UPDATE solo con los campos recibidos
foreach ($camposPermitidos as $campo) {
if (array_key_exists($campo, $payload)) {
$camposAActualizar[] = "$campo = :$campo";
$parametros[$campo] = $payload[$campo];
}
}
if (empty($camposAActualizar)) {
ApiResponse::error('No se enviaron campos válidos para actualizar', 400);
}
$sql = 'UPDATE productos SET ' . implode(', ', $camposAActualizar) . ' WHERE id = :id';
$stmt = $db->prepare($sql);
$stmt->execute($parametros);
ApiResponse::success(null, "Producto con ID $id actualizado con éxito");
}
/**
* DELETE /api/productos/{id}
*/
public function eliminar(int $id): void
{
$db = Database::getConnection();
// 1. Verificar existencia
$check = $db->prepare('SELECT id FROM productos WHERE id = :id');
$check->execute(['id' => $id]);
if (!$check->fetch()) {
ApiResponse::error("Producto con ID $id no encontrado para eliminar", 404);
}
// 2. Ejecutar borrado
$stmt = $db->prepare('DELETE FROM productos WHERE id = :id');
$stmt->execute(['id' => $id]);
// 3. Responder con 200 OK o 204 No Content
ApiResponse::success(null, "Producto $id eliminado permanentemente");
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lecciónSi un cliente intenta ejecutar DELETE /api/productos/99 pero el producto con ID 99 no existe en la base de datos, ¿qué código HTTP debe responder la API?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar APIs RESTful con PHP Puro, JSON & JWT y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.