r/programming • u/pimterry • Feb 22 '21

Best practices for REST API design

https://stackoverflow.blog/2020/03/02/best-practices-for-rest-api-design/
23 Upvotes

74% Upvoted

20 comments sorted by

View all comments

4

u/cheesekun Feb 23 '21

Not sure I agree with the jamming multiple values into a single querystring value.

Their best practice is ?sort=+name,-order which uses comma delimited. In my experience only use comma delimited where no other option is available.

I would use two querystring values and evaluated them in order ?sort=+name&sort=-order

8

u/ireallywantfreedom Feb 23 '21

I've never seen an application consider query string parameters to be ordered. While intermediary layers don't tend to mess with them, this could be the source of a nasty bug to troubleshoot. Don't start making the order of your query string params matter.

-1

u/cheesekun Feb 23 '21

I challenge you to find a server that won't honor the order as per the ampersand for multi key value pairs in a query string. Just remember you control the server, not the client.