REST：HTTP动词和端点的名称是什么？

Question

鉴于此：

GET /users

/users在REST术语中称为endpoint。

如何调用整个GET /users（动词+端点）？我希望有一个词可以解决。

感谢。

Answer 1

你可能不会喜欢这个答案，但无论如何它是：REST根本不使用术语“端点”。您可以自己检查Fielding的论文：http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm - 打开PDF并搜索“端点”。

Fumanchu的答案可能是你得到的最接近的答案：“/ Users”是一个相对路径，可以根据2616 HTTP规范用作请求行中的Request-URI。

在Web API文档中，我可能会像您一样将“/ Users”称为“端点”引用，“GET / Users”将是“操作”。也许你可以在这里获得一些灵感：https://nhs.3scale.net/docs

Answer 2

API Bluprint Language Specification在应用于资源时将HTTP方法称为resource action。此名称似乎与section 5.2.1.2 Representations, of Fielding's dissertation中的术语一致。

Answer 3

RFC 2616（HTTP规范）将请求的第一行称为“请求行”。它由方法，Request-URI和版本组成。有关完整的详细信息，请参阅http://tools.ietf.org/html/rfc2616#section-5.1。

Answer 4

我们称之为'资源运作'

基本上，您正在映射您的操作，如

• 创建新用户
• 获取用户信息
• 更新用户信息
• 删除用户

到“HTTP动词+资源”

• POST / user /
• GET / user /
• PUT / user /
• DELETE / user /