Re:Most RESTful APIs Aren't RESTful
by thaumasiotes on Wednesday July 09, 2025 @08:58PM
(#44516228)
> So then one gets to bike-shed if "signup" it is in the request path, query parameters, or the body.
But that's not a difference between /user/signup and /user:signup .
Re:Most RESTful APIs Aren't RESTful
by no_circuit on Wednesday July 09, 2025 @10:12PM
(#44516552)
That's correct, the example you are giving represents bike-shedding among request path variations.
I assumed most readers of my comment would get that the idea that /users/signup is ambiguous whether or not that is supposed to be another resource, while /users:signup is less so.
So then one gets to bike-shed if "signup" it is in the request path, query parameters, or the body. Or that since the user resource doesn't exist yet perhaps one can't call a method on it, so it really should be /users:signup (on the users collection, like /users:add).
Provided one isn't opposed to adopting what was bike-shedded elsewhere, there is a fairly well specified way of doing something RESTful, here is a link to its custom methods page: https://google.aip.dev/136. Its approach would be to add information about signup in a request to the post to /users: https://google.aip.dev/133. More or less it describes a way to be RESTful with HTTP/1.1+JSON or gRPC.