c# - 对什么是基于 REST 的 API 感到困惑

Question

我想了解什么是基于 REST 的 API。据我了解，这只是在 API 中编写函数的约定？所有函数都应该是 GET/POST/DELETE/PUT 形式吗？因此，例如 REST API 中的函数可以是

public string getLastName(User x)
{
    return x.lastName;
}

我主要对 JSON/XML 如何在其中发挥作用感到困惑？

Answer 1

它不仅仅是一个约定。 REST API 背后的概念是您使用 HTTP 动词访问它，并且这些动词的功能已被映射以执行所描述的操作。

例如:

GET 将数据返回给调用者/发送者

DELETE 将删除一条记录

它更进一步，但其中很多是基于依赖 HTTP 来提供一定程度的一致性。例如，在 RESTful 服务中，您可以使用 Accept HTTP header 通过提供 application/json 或 application/来请求 JSON 响应或 XML 响应xml 值，分别。这只是一个简单的例子，由实现者决定他们的 API 如何工作，但它强调了利用 HTTP 的重要性。

为什么选择 JSON/XML？

同样，使用 JSON 和 XML 是因为它们是通过网络表示和传输数据的广泛且标准的方式。由于大多数请求来自 JavaScript，因此 JSON(JavaScript Object Notation)在进行数据传输(尤其是 GET 请求)时非常常见，并且 JS 可以轻松地与 JSON 交互，而无需进行处理 XML 时所需的解析。另一方面，XML 提供了它自己的好处，例如使用模式和命名空间的能力。您可能已经意识到每种方法的优点/缺点，但这是一个单独的讨论。要点是 JSON/XML 是 REST API 中传输数据的主要方式，因为它们都是网络的实际标准。

有很多很好的资源可以获取更多信息，这篇 MSDN 文章可能会有帮助:http://msdn.microsoft.com/en-us/library/dd203052.aspx