api-design - API 端点语义

Question

API 端点是“方法”，例如https://api.foursquare.com/v2/venues/还是包含非查询字符串参数的完整 URL，例如 https://api.foursquare.com/v2/venues/ 5104

换句话说，这两个独立的端点还是被认为是同一个端点？ http://myapi.com/somemodel/1
http://myapi.com/somemodel/2

Answer 1

根据这篇 Wikipedia article，端点是一个 Web 服务，由 WSDL 文件定义，并且

仅定义 Web 服务的地址或连接点。它通常由一个简单的 HTTP URL 字符串表示。

Microsoft在各种上下文中使用该术语endpoint，但它们都等同于同一件事：端点是整个接口，而不是一种特定的方法。

在REST端点的上下文中，端点将包含必要的 GET、PUT、POST 和 DELETE 方法（如适用）。