JavaScript:学习如何"使用RESTful API"

Question

JavaScript:学习如何"使用RESTful API"

joe*_*moe 8 javascript ajax rest jquery

我已经编写JS几年了,现在我正在学习更多.看到很多雇主要求"REST API知识"或"体验消费RESTful服务".

我了解AJAX的基础知识,包括原生JS和jQuery.我在SO和网络上做了很多关于REST的工作.关于如何使用JAVA,C#等在服务器端构建RESTful API似乎有大量信息,但关于如何使用JavaScript访问这些服务的信息很少.

以下是问题:

"消费RESTful服务"是另一种说"使用AJAX从服务器获取数据"的方式,还是完全不同的东西？
如果是别的什么,关于这个主题的一些好的教程在哪里？
一旦我掌握了基础知识,我在哪里可以找到网络上的RESTful API来使用？

Answer 1

Bra*_*don 9

"消费RESTful服务"是另一种说"使用AJAX从服务器获取数据"的方式,还是完全不同的东西？

不,完全没有,但您当然可以使用AJAX使用自己的REST API.Ajax通常只是意味着xmlHttpRequest,它本身就是一个Web浏览器概念.RESTful API更像是一个服务接口.在许多方面,它是一个Web服务,但没有SOAP的复杂性.

从本质上讲,REST是一种通过使用动词和名词来表达HTTP上的事务或查询的方法.例如,要获取信息,请使用...等待... GET!要放置信息,你使用PUT(或POST,下面的教程将解释差异).要删除某些内容,请使用DELETE.它相当整洁.它几乎像HTTP上的句子:

GET /users/123
DELETE /users/123

Run Code Online (Sandbox Code Playgroud)

你可以猜出那些会做什么.

因为这些只是HTTP请求,所以通常可以使用AJAX来使用它们,但这并不是必需的.实际上,我发现REST API对于将服务或数据公开给其他应用程序更有用,就像Web服务一样.

如果是别的什么,关于这个主题的一些好的教程在哪里？

由于两个原因,很难给出一个关于使用RESTful服务的好教程:

每项服务都不同.
这取决于您使用的语言/平台.

布雷特的回答提到了一些很好的教程.

这是一个SO答案,它显示了直接在Java中使用REST的方法:如何在Java中使用REST

这是一个合理的教程,介绍如何使用Java中的JAX-RS API创建RESTful API,然后演示如何使用它:http://www.mkyong.com/webservices/jax-rs/restfull-java-client-与Java的净网址/

我在Jersey的REST客户端也取得了很大的成功.他们的REST(JAX-RS)服务器软件是一种皇家的痛苦(在我看来),但他们的客户端很漂亮.

我在去年春天用Java编写了一个简单的概念验证todo列表REST API,并且集成测试显示了Jersey客户端很好地使用API来进行测试.

https://github.com/brandonramirez/todo-api/blob/master/src/test/java/com/brandonsramirez/todoApi/TaskResourceTest.java

我也是Unirest客户端的粉丝,它是一个REST客户端,翻译成几种具有类似界面的语言.它们有Objective-C版本,Java版本,JavaScript/node.js版本,.NET版本等.

如果雇主正在寻找使用REST API的经验,他们可能需要五件事:

您是否了解使用各种方法以及随之而来的设计模式,命名约定等通过HTTP交换数据的基本语义？
您是否认识到将CRUD操作映射到HTTP请求的事实标准(比如 GET /resources用于列出所有资源,POST /resources创建新资源,PUT /resources/x更新资源X等)？
您是否熟悉各种HTTP响应代码以及何时/如何使用它们？您是否总能认为成功的响应会产生200状态代码？如果您创建新资源,是否有另一个常用的状态代码(是的,有)？
您是否实际编写了任何代码来使用现有服务？
你能轻松测试一项服务吗？例如,使用curl非常精确地创建HTTP请求.

还有一个奖励,但大多数人都没有很好地掌握这一点(我很难理解其个人用途),是通过翻阅Accepts标题进行版本控制的超媒体.

一旦我掌握了基础知识,我在哪里可以找到网络上的RESTful API来使用？

遍!每个人都有一个!Twitter,Facebook,Twilio,Stripe,Google,Edmodo,亚马逊.我可以永远继续下去.在IaaS领域,Amazon Web Services和Rackspace Cloud都提供RESTful API来管理您的云基础架构.例如,我可以向表示我的服务器集的URL发出HTTP POST请求,然后为我提供新的服务器(虚拟机).

https://stripe.com/docs/api

https://api.imgur.com/

有很多甚至有中心服务可以帮助消费者找到API和供应商发布它们,例如Mashape和Mashery,尽管后者似乎更关注提供商而不是消费者,从他们的网站来看.

我之前发布的github项目,带有我的概念验证,从Searchly和Twilio访问REST API,以便我可以搜索任务,当一个标记为完成时,再次向我发送一条短信,来自HTTP请求.但是,我使用来自这些提供程序的客户端库而不是使用直接HTTP库来使代码更精简和更集中,而不必担心所有的HTTP管道.