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

- Derek Dahmer

Answer 1

根据这篇维基百科文章，端点是由WSDL文件定义的Web服务，其仅仅定义了Web服务的地址或连接点。通常用一个简单的HTTP URL字符串表示。

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

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

- Robert Harvey

---

那么，http://myapi.com/mymethod/1 和 http://myapi.com/mymethod/2 是同一个端点吗？ - Derek Dahmer

是的，前提是1和2是您方法的参数，而不是指向自己完整端点接口地址的地址（虽然这种设计可能性是存在的，但我不会这样设计）。 - Robert Harvey

根据维基百科的定义，每个URL都指向提供1和2描述的资源数据的服务，因此它们是两个不同的端点。我认为一个端点应该仅是后缀，并且它们可以共享相同的基本URL。 - HukeLau_DABA

@HukeLau_DABA：还要看看维基百科文章如何定义“操作”。 - Robert Harvey