DifícilSelección múltiple

Pregunta de práctica de 200-901

¿Cuáles DOS afirmaciones sobre las mejores prácticas de diseño de API REST son correctas?

Elige todas las respuestas correctas.

Respuestas correctas

  • CLos recursos deben representarse utilizando sustantivos en el URI
  • ELos verbos HTTP deben describir la acción realizada sobre el recurso

Explicación

La opción C es correcta porque las mejores prácticas de REST dictan que los URI identifican recursos, no acciones, por lo que deben usar sustantivos (por ejemplo, /users/123) en lugar de verbos como /getUser. La opción E es correcta porque en REST el propio método HTTP transmite la acción sobre el recurso — GET recupera, POST crea, PUT reemplaza, PATCH actualiza parcialmente y DELETE elimina — manteniendo el URI libre de acciones. La opción A es incorrecta porque el versionado se realiza comúnmente mediante la ruta del URI (por ejemplo, /v1/users), tipos de medios personalizados o cabeceras, y no únicamente mediante parámetros de consulta. La opción B es incorrecta porque PUT está destinado al reemplazo completo de recursos, mientras que PATCH es el método correcto para actualizaciones parciales. La opción D es incorrecta porque las respuestas REST típicamente incluyen una representación (JSON/XML) en el cuerpo junto con el código de estado, y no solo un código de estado vacío.

Por qué cada opción es correcta o incorrecta

A

Incorrecta

El versionado de la API debe implementarse utilizando únicamente parámetros de consulta

El versionado por parámetros de consulta contamina los identificadores de recursos y complica el almacenamiento en caché y el enrutamiento; el versionado por ruta URI o tipo de medio es estándar. Es tentador porque las cadenas de consulta son rápidas de agregar y se adaptarían a parámetros de filtrado o paginación en lugar de la negociación de versiones de la API.

B

Incorrecta

El método HTTP PUT debe utilizarse para actualizaciones parciales de un recurso

PUT reemplaza toda la representación del recurso, por lo que los campos omitidos se sobrescriben; las actualizaciones parciales corresponden a PATCH. Es tentador porque PUT es familiar e idempotente, y sería correcto cuando el cliente envía una representación de reemplazo completa del recurso.

C

Correcta

Los recursos deben representarse utilizando sustantivos en el URI

REST trata todo como un recurso, por lo que los URI deben nombrar dichos recursos con sustantivos (por ejemplo, /orders/42) en lugar de verbos o acciones. El método HTTP transmite entonces la operación, manteniendo la interfaz uniforme y predecible.

D

Incorrecta

Las respuestas deben devolver únicamente códigos de estado HTTP sin un cuerpo

Los códigos de estado por sí solos no proporcionan a los clientes ninguna representación del recurso creado o actualizado, rompiendo el contrato orientado a recursos de REST. Es tentador porque los códigos son compactos y se pueden almacenar en caché, y se adaptarían a puntos finales como DELETE o respuestas 204 No Content donde no se devuelve ninguna entidad.

E

Correcta

Los verbos HTTP deben describir la acción realizada sobre el recurso

Los verbos HTTP transportan la semántica de la operación: GET recupera, POST crea, PUT reemplaza y DELETE elimina. Codificar la acción en el método en lugar del URI mantiene los recursos direccionables por sustantivo y preserva un comportamiento uniforme y almacenable en caché.

Para profundizar

REST trata todo como un recurso identificado por un URI, por lo que las rutas deben usar sustantivos en plural (por ejemplo, /orders/42) en lugar de verbos como /getOrder, permitiendo que el método HTTP transmita la operación: GET recupera, POST crea, PUT reemplaza, PATCH actualiza parcialmente, DELETE elimina. Esta separación permite el almacenamiento en caché, garantías de idempotencia e intermediarios uniformes. Un detalle sutil que vale la pena conocer es que PUT se define como un reemplazo completo, por lo que usarlo para actualizaciones parciales puede anular silenciosamente los campos omitidos, razón por la cual existe PATCH. En una integración real, un cliente que envíe PUT con solo un campo de correo electrónico modificado podría borrar el nombre y la dirección del usuario, mientras que un PATCH /users/42 diseñado correctamente con un cuerpo parcial actualiza solo los atributos proporcionados.

Sobre estas preguntas de práctica

Esta es una de las preguntas de práctica originales de 200-901 de Courseiva, escrita para aprender y nunca copiada de exámenes reales ni de dumps.

Traducida del original en inglés con IA y revisada para comprobar el sentido. Los códigos de examen, los comandos y los nombres de productos se mantienen tal como aparecen en el examen.