¿Cuál es el argumento para los sustantivos singulares en los nombres de recursos RESTful API?

12

Entiendo que cuando se nombran RESTful URI, se acepta comúnmente el uso de plurales para representar colecciones de recursos. Tengo curiosidad sobre el argumento para usar sustantivos singulares en su lugar.

caridad
fuente
¿Quizás porque no todo es una colección?
Jwenting
¿No es allí donde entraría en juego un recurso singleton?
charness

Respuestas:

12

Algunos recursos contienen solo un único elemento. Un buen ejemplo sería todo para lo que no necesita una identificación para averiguar qué datos representar. Muy común, por ejemplo, sería el recurso de inicio de sesión. Tiene (desde la vista de usuarios y navegadores) solo un inicio de sesión único. Puede crearlo, puede destruirlo, pero no tendrá una acción de índice con varios inicios de sesión para elegir.

Ejemplos similares serían algunas páginas en su mayoría estáticas, como información de la empresa, impresiones, formularios de contacto y cosas similares que solo muestran un solo elemento o solo permiten una sola acción de creación.

Podría ser un tema de discusión si el uso de sustantivos singulares realmente agrega mucho a la legibilidad del código.

Thorsten Müller
fuente
5

Porque:

  1. Las reglas plurales en inglés como "cerezas" no son lo mejor que se puede pensar al desarrollar API, particularmente cuando el inglés no es su lengua materna.
  2. A veces desea generar un punto final a partir del modelo, que generalmente es singular. No juega muy bien con lo anterior.
  3. El argumento "por lo general comienza a consultar por un Get para mostrar una lista" no se refiere a ningún caso de uso real. Y terminará consultando elementos individuales tanto o incluso más que una lista de elementos.
Benoit
fuente