argob / estandares

Estándares de Servicios Digitales
MIT License
92 stars 48 forks source link

REST verbs #3

Closed nicosantangelo closed 8 years ago

nicosantangelo commented 8 years ago

Dentro de la tabla que especifica los verbos de HTTP a usar

HTTP METHOD POST GET PUT DELETE
CRUD OP CREATE READ UPDATE DELETE
/articulos Crea nuevo artículo Lista de artículos Actualiza un artículo Elimina todos los artículos
/articulos/1234 Error Muestra el artículo 1234 Si existe, actualiza el artículo; sino, devuelve error. Borra 1234

hay dos cosas que me llaman la atención:

  1. Cómo realizar un PUT desde /articulos sin especificar a qué recurso nos estamos refiriendo
  2. No está especificado el verbo PATCH que es de mucha utilidad si se quiere cambiar parte de un recurso. La semántica de PUT es tomar el recurso que llega en el request y cambiarlo por el existente si existe y sino crearlo. En cambio PATCH describe los cambios a realizar en el recurso parcialmente. No se si es necesario agregar el verbo pero tal vez resulta un poco confusa la definición de PUT ya que en la descripción de la sección dice

Los verbos HTTP, o métodos, se deben utilizar en el cumplimiento de sus definiciones de la norma 1.1 / HTTP (...)

mncrespi commented 8 years ago

Se corrigió el caso de PUT para el recurso /articulos. Se analizará si agregamos PATCH. Gracias por colaborar!