REST API入口点和端点

Question

REST API入口点是什么，它与端点有何不同？

我在网上搜索了各种定义，但似乎仍然无法绕开它们（一般来说，我是API的新手）。据我了解，它们提供了与服务器进行通信的方式，但是它们到底是什么？入口点和端点如何相似或不同？

Answer 1

简而言之，进入点可能就是http://api.your-company.com客户无需任何先验知识就可以进入的东西。API将教客户需要知道的一切，以便对其下一步可以做的事情做出明智的选择。

关于端点维基百科，即声明以下内容：

端点，是面向服务的体系结构中服务，流程或队列或主题目的地的入口点

从广义上讲，端点只是被调用的目标主机，应处理您的请求（或在负载平衡的情况下委托给其他一些机器，否则就不行）。从更狭义的意义上讲，端点只是调用正在处理您的请求的服务器端内容，即URI之类的http://api.your-company.com/users/12345将要求用户表示（假定为GET请求）。具体的用户是处理的资源，而端点实际上可能是基于Spring（或您选择的框架）的服务，用于处理针对所有http://api.your-company.com/users/*相关内容的所有请求。

Answer 2

在这里同意Roman Vottner的意见。我只想在这里添加一些链接，以供尝试获得清晰想法的任何人使用。

API端点

我喜欢这里的答案：https : //smartbear.com/learn/performance-monitoring/api-endpoints/

“简单地说，端点是通信通道的一端。当API与另一系统交互时，此通信的接触点被视为端点。对于API，端点可以包括服务器或服务的URL。每个端点都是API可以从中访问其执行功能所需的资源的位置。”

这里的示例：什么是端点？

  https://example.com/api/login
  https://example.com/api/accounts
  https://example.com/api/cart/items

API入口点

看这里：https : //restful-api-design.readthedocs.io/en/latest/urls.html

“一个RESTful API需要有一个并且恰好是一个入口点。入口点的URL需要传达给API客户端，以便他们可以找到API。从技术上讲，入口点可以看作是存在的单例资源。在任何收藏之外。”

因此，按照前面的示例，它将是：

  https://example.com/api

附加说明：在GraphQL世界中，有一个single endpointAPI接口，没有入口点（https://graphql.org/learn/best-practices/#http）。通常形式

  https://example.com/graphql