Restapi Naming Convention for Boolean Endpoints

Restapi Naming Convention for Boolean Endpoints

It is a trivial question but I cannot find an answer. Lets say I have an endpoint that simply checks if a user exists within a certain group and returns a boolean. What should the RestAPI path look like?

/api/user/{id}/exists/{group}

/api/user/{id}/in/{group}

/api/user/{id}/is_assigned/{group}

/api/user/{id}/exists_within/{group}

I feel like the API path name should read organically, but I also don't like using an underscore. What do you guys suggest?

1

1 Answer

REST doesn't care what spellings you use for your identifiers.

PUT /abff1822-71aa-4147-9b91-18a8a4f1bf6c
Content-Type: application/json

true
PUT /abff1822-71aa-4147-9b91-18a8a4f1bf6c
Content-Type: application/json

false
GET /abff1822-71aa-4147-9b91-18a8a4f1bf6c

Old school POST also "just works"

POST /abff1822-71aa-4147-9b91-18a8a4f1bf6c
Content-Type:application/x-www-form-urlencoded

value=true

URI are a lot like variable names - the machines don't care, and because they don't care you can follow whatever local spelling conventions make sense.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Robert Thorne
Author

Robert Thorne

Robert Thorne covers electric vehicle innovations, autonomous driving systems, global mobility trends, and automotive engineering developments.