REST: what is the name for the HTTP verb and endpoint?

Question

Considering this:

GET /users 

/users is called REST endpoint terminology.

What do you call all GET /users (verb + endpoint) instead? I hope there is one word for this.

Thanks.

Answer 1

You probably won't like this answer, but it doesn't matter here: REST does not use endpoint terminology at all. You can check the Fielding theses yourself: http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm - open the PDF file and find the "endpoint".

Fumanchu's answer is probably closest to you: "/ Users" is a relative path and can be used as Request-URI in the query string according to the HTTP specification 2616.

In the web API documentation, I would probably call "/ Users" the "Endpoint" link like you would, and "GET / Users" would be "Operation". Perhaps you can get inspiration here: https://nhs.3scale.net/docs

Answer 2

The Bluprint Language Specification API refers to the HTTP method when applied to a resource as a resource action . This name seems to be consistent with the terminology in section 5.2.1.2. Views, description Fielding .

Answer 3

RFC 2616 (HTTP specification) calls the first line of the Request-Line request. It consists of a method, Request-URI and version. See http://tools.ietf.org/html/rfc2616#section-5.1 for more details.

Answer 4

We call it "resource operation"

You basically map your operations like

• Create new user
• Get user info
• Update User Information
• Delete user

in "HTTP verb + resource"

• POST / user /
• Get / user /
• PUT / user /
• DELETE / user /