Github utilizza la convenzione "/ utente" (singolare) per interagire con le informazioni di utente registrato . Hanno ancora la suite completa di percorsi "/ users" per supportare l'acquisizione di informazioni basate su ID (o nomi utente nel loro caso), ma la singolare risorsa mi ha colto di sorpresa.
Questo è comune / accettato / desiderato attraverso il web, o è solo una stranezza che Github usa?
Is this common/accepted/desired across the web, or is this just a quirk that Github uses?
Direi "insolito, ma accettabile". Ad esempio, l'API stackexchange utilizza / me come una scorciatoia per "l'utente associato a questo token di accesso".
the singular resource took me by surprise
Davvero non dovrebbe (anche se non è colpa tua se lo ha fatto). Le convenzioni dell'URI asseriscono che i segmenti del percorso sono organizzati gerarchicamente, ma non vi è alcun requisito o aspettativa che la radice è riservata solo alle raccolte.
L'esempio canonico potrebbe essere /index.html .
È possibile che una API utilizzi l'ortografia /users/me ? Bene, a REST non interessa come sono scritti gli URI, e questa è certamente una ragionevole organizzazione di una gerarchia, quindi RFC 3986 è soddisfatto. Sono solo segmenti di percorso, quindi dovrebbe essere semplice per qualsiasi implementazione di routing ragionevole.
Un'organizzazione può ragionevolmente decidere di non volere due (o più) regole di corrispondenza in gioco sotto una determinata radice.
In realtà si tratta solo delle convenzioni che un'organizzazione ritiene possa favorire una migliore adozione.