2. Métodos HTTP Semánticos: GET, POST, PUT, PATCH, DELETE y OPTIONS
Domina el significado de los verbos HTTP, la diferencia entre idempotencia y seguridad, y cuándo utilizar PUT frente a PATCH para actualizaciones.
La Semántica de los Verbos HTTP
En el desarrollo web tradicional de formularios HTML, solo se utilizaban GET y POST. En una verdadera arquitectura RESTful, los verbos del protocolo HTTP indican con precisión la intención semántica de la acción sobre el recurso.
| Método HTTP | Operación CRUD | ¿Es Seguro? | ¿Es Idempotente? | Descripción |
|---|---|---|---|---|
| GET | Read (Leer) | ✅ Sí | ✅ Sí | Solicita la representación de uno o varios recursos. Nunca debe modificar datos en la base de datos. |
| POST | Create (Crear) | ❌ No | ❌ No | Envía un payload para crear un nuevo recurso secundario. Cada llamada genera un nuevo registro. |
| PUT | Update (Reemplazar) | ❌ No | ✅ Sí | Reemplaza la totalidad del recurso existente por el payload enviado. Si no envías un campo, queda nulo o borrado. |
| PATCH | Update (Parcial) | ❌ No | ❌ No (o Sí) | Aplica modificaciones parciales. Solo actualiza los campos especificados en el JSON sin alterar los demás. |
| DELETE | Delete (Eliminar) | ❌ No | ✅ Sí | Elimina el recurso identificado por la URI. |
| OPTIONS | Preflight / Consulta | ✅ Sí | ✅ Sí | Pregunta al servidor qué métodos y cabeceras CORS están permitidos antes de enviar la petición real. |
¿Qué es la Idempotencia en HTTP?
•
DELETE /api/usuarios/5 es idempotente: tras la primera ejecución el usuario 5 fue borrado; repetir la petición no altera el estado final.•
POST /api/pedidos NO es idempotente: cada ejecución crea un nuevo pedido duplicado y realiza un nuevo cobro.
⚡ Detección y Manejo de Verbos HTTP en PHP Nativo
Ejemplo de cómo capturar e inspeccionar el método de la petición entrante en PHP puro:
<?php
declare(strict_types=1);
header('Content-Type: application/json; charset=utf-8');
// Obtener el método HTTP de la petición (GET, POST, PUT, DELETE, etc.)
$metodo = strtoupper($_SERVER['REQUEST_METHOD'] ?? 'GET');
// Soporte para simulación de métodos mediante cabecera X-HTTP-Method-Override
if ($metodo === 'POST' && isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) {
$metodo = strtoupper($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']);
}
switch ($metodo) {
case 'GET':
http_response_code(200);
echo json_encode(['accion' => 'Consultando colección de datos']);
break;
case 'POST':
http_response_code(201);
echo json_encode(['accion' => 'Creando nuevo recurso']);
break;
case 'PUT':
case 'PATCH':
http_response_code(200);
echo json_encode(['accion' => 'Actualizando recurso existente', 'tipo' => $metodo]);
break;
case 'DELETE':
http_response_code(200);
echo json_encode(['accion' => 'Recurso eliminado satisfactoriamente']);
break;
case 'OPTIONS':
// Respuesta rápida a preflight CORS
http_response_code(204);
break;
default:
http_response_code(405); // 405 Method Not Allowed
echo json_encode(['error' => "Método $metodo no permitido en este endpoint"]);
break;
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la diferencia técnica entre los métodos PUT y PATCH al actualizar un recurso en una API REST?
¿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.