javascript - JavaScript 中 REST API 客户端库的好例子有哪些

Question

已结束。此问题正在寻求书籍、工具、软件库等的推荐。它不满足 Stack Overflow guidelines 。目前不接受答案。

---

我们不允许提出寻求书籍、工具、软件库等推荐的问题。您可以编辑问题，以便用事实和引文来回答。

已关闭 6 年前。

Improve this question

我正在寻找在轻量级 JavaScript 客户端中包装 REST API 的最佳实践样式。

过去我见过以如下风格实现的库:

var request = new SearchRequest(apikey);
request.query = "search term";
request.send(function(results) {
    console.log(results);
});

或者更明确地拥抱 HTTP，例如:

api.get("search", "search term", function(results) {
    console.log(results);
});
api.post("comment", comment, function(results) {
    console.log(results);
});

或者更高层次的包装:

api.search("search term", function(results) {
    console.log(results);
});
api.createComment(comment, function(results) {
    console.log(results);
});

您最近看到过哪些包装 REST API 的现代 JavaScript 客户端库的好例子。不关心实现细节，只关心 API 设计。

谢谢!

Answer 1

我观看了一个关于优秀 API 设计的非常好的视频。绝对值得一看。

RESTful API Design - Second Edition

除了上述视频之外，您还可以访问 https://offers.apigee.com/ebook-api-design-yt/ 获取免费书籍 Web API 设计 - 开发人员喜爱的制作界面

关于包装器，可能值得考虑以下问题:

1. 使包装保持一致。

采用您正在使用的编程语言或社区的标准、命名约定等，以使包装器对于使用它的人来说尽可能自然。

包装还是抽象？这就是问题所在。

通过包装，您可以尽可能多地模仿 REST API 方法和结构，但只是让一些困难的事情变得更容易。这种方法的最大优点之一是，当目标 REST API 升级时，可以更轻松地进行升级。

抽象当目标 REST API 很复杂或以非标准方式表现和外观时非常有用。在这种情况下，您的包装器方法和调用可能根本不像您的目标 REST API 方法，但最终会简化(希望如此)使用您的包装器的用户的生活。