Tema 2 · Métodos HTTP

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?

💡 Concepto Clave: Un método es idempotente si ejecutarlo una sola vez o ejecutarlo 100 veces consecutivas produce exactamente el mismo efecto en el estado del servidor.
• 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:

detectar-metodos.php
Solo lectura
<?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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.