Métodos HTTP: Errores comunes y preguntas de entrevista

Elegir el método HTTP correcto en una API web es crucial, sin embargo, muchos desarrolladores cometen errores al responder preguntas o implementar soluciones que giran en torno a este concepto. Las preguntas en las entrevistas a menudo confunden a los candidatos porque profundizan en sutilezas que podrían no estar documentadas explícitamente, lo que lleva a problemas reales desconcertantes.

Para ilustrar, considera un escenario en el que un desarrollador aspirante podría confundir el papel de los métodos POST y PUT al interactuar con APIs RESTful. En una entrevista, se les puede preguntar sobre las diferencias entre estos métodos o cómo abordarían la actualización de recursos en diferentes contextos. Esta confusión puede fácilmente traducirse en malentendidos con los equipos de backend o resultar en un comportamiento subóptimo de la aplicación.

Entendiendo los Métodos HTTP

En el contexto de las APIs RESTful, los principales métodos HTTP son GET, POST, PUT, PATCH y DELETE. Cada uno de estos métodos tiene un propósito específico en relación a las interacciones con recursos en un servidor.

• GET: Recuperar datos de un servidor
• POST: Enviar datos para ser procesados (como crear un nuevo recurso)
• PUT: Actualizar un recurso por completo
• PATCH: Actualizar un recurso parcialmente
• DELETE: Eliminar un recurso

Las sutilezas entre POST y PUT, en particular, pueden confundir tanto a candidatos como a desarrolladores junior. Dado que estos métodos están estrechamente relacionados y a menudo se utilizan incorrectamente, es esencial centrarse en sus aplicaciones adecuadas en diferentes escenarios.

Ejemplo de Código:

Aquí hay un ejemplo mínimo de código usando Express.js para demostrar cómo definir rutas para varios métodos HTTP:

const express = require('express');  
const app = express();  
app.use(express.json());  // Middleware para analizar cuerpos JSON

// Método GET para recuperar datos
app.get('/api/resource', (req, res) => {
    res.send('Recuperando recurso...');
});

// Método POST para crear datos
app.post('/api/resource', (req, res) => {
    const newResource = req.body;
    res.status(201).send(newResource);
});

// Método PUT para actualizar datos completamente
app.put('/api/resource/:id', (req, res) => {
    const updatedResource = req.body;
    res.send(`Recurso actualizado con id ${req.params.id}`);
});

// Método DELETE para eliminar datos
app.delete('/api/resource/:id', (req, res) => {
    res.send(`Recurso eliminado con id ${req.params.id}`);
});

app.listen(3000, () => {
    console.log('El servidor está corriendo en el puerto 3000');
});

Este fragmento de código destaca cómo se pueden utilizar varios métodos HTTP en una aplicación Express.js. Usar el método correcto para cada acción es fundamental.

Trampas en la Entrevista

Al discutir los métodos HTTP, los entrevistadores a menudo indagan más profundamente en las sutilezas y esperan que los candidatos articulen no solo sus definiciones, sino sus aplicaciones prácticas. Aquí hay trampas específicas en las que los candidatos suelen caer:

• Confundir POST y PUT: Los candidatos a menudo describen ambos métodos como intercambiables, sin reconocer que POST se utiliza generalmente para la creación, mientras que PUT es para actualizar recursos existentes por completo.
• Malentendido de PATCH: Algunos candidatos pueden confundir PATCH con PUT, sin darse cuenta de que PATCH está destinado a actualizaciones parciales, mientras que PUT requiere el recurso completo.
• Ignorar la falta de estado: Las preguntas de entrevista pueden evaluar la comprensión de un candidato sobre los métodos HTTP en el contexto de la comunicación sin estado, enfatizando que cada solicitud debe contener toda la información necesaria para que el servidor la cumpla.
• No mencionar métodos idempotentes: Los candidatos pueden pasar por alto la definición de idempotencia respecto a métodos como PUT y DELETE, que deberían producir el mismo resultado sin importar cuántas veces se llamen con los mismos parámetros.

Ejemplo de Trabajo: Tratando con PUT vs. PATCH

Imagina que te han encargado crear una API RESTful para manejar perfiles de usuario. Cada perfil tiene múltiples campos: nombre, correo electrónico y biografía.

Si te preguntan qué método usar al actualizar solo el campo de correo electrónico del perfil de un usuario, discutir tu elección podría ir así:

1. Identificación del tipo de actualización: Dado que solo estás cambiando una parte del perfil del usuario en lugar de reemplazar todo el objeto, te inclinarías hacia PATCH.
2. Justificación de la elección: Explica que PATCH permite actualizaciones parciales, lo que conserva ancho de banda y reduce la transmisión de datos en comparación con enviar todo el recurso con PUT.
3. Ejemplo de Llamada a la API: Podrías ilustrar cómo configurarías la llamada a la API:

fetch('https://api.example.com/users/123', {
    method: 'PATCH',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({ email: 'nuevocorreo@example.com' })
});

1. Aclarando Restricciones: Deja claro que usar PUT para reemplazar un objeto completo requeriría enviar todos los campos del perfil, no solo el correo electrónico, lo que es ineficiente y contrario a las mejores prácticas.

Explicar tu razonamiento de esta manera demuestra una comprensión profunda de los métodos HTTP que puede impresionar a los entrevistadores.

En el Trabajo: Implicaciones en el Mundo Real

En el mundo real, el uso incorrecto de los métodos HTTP puede llevar a una serie de problemas:

• Sobrescritura de Datos: Usar POST en lugar de PUT puede llevar a sobrescrituras accidentales de recursos, donde un nuevo recurso podría reemplazar incorrectamente a uno existente debido a confusión sobre la intención.
• Comportamiento Inconsistente de la API: Si los desarrolladores no cumplen con el uso esperado de los métodos HTTP (como no hacer que los puntos finales GET sean seguros o los puntos finales DELETE sean idempotentes), la API puede comportarse de manera impredecible, lo que lleva a una experiencia de desarrollador negativa y errores no planificados.
• Problemas de Rendimiento: Usar PUT para actualizaciones parciales puede llevar a que se envíen datos innecesarios a través de la red, afectando el rendimiento. Esto es especialmente crucial para aplicaciones móviles, donde el ancho de banda y la capacidad de respuesta a menudo son limitados.

Entender el método HTTP correcto para elegir para una tarea particular es una habilidad fundamental que puede diferenciarte en entrevistas de trabajo y en las prácticas de desarrollo diario. Adaptarse a estas sutilezas puede ayudar a crear APIs eficientes y predecibles que mejoren la experiencia del usuario y mantengan la claridad en las bases de código.

Referencias

• MDN Web Docs sobre Métodos HTTP
• Diseño de API RESTful: Mejores Prácticas en Diseño de API
• Documentación de Express.js
• ¿Qué es REST? - Tutorial de API REST