expressjs rest API的好模式？ - 腾讯云开发者社区 - 腾讯云

开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

REST API和GraphQL API的比较

REST API REST（表述性状态传输）API 是一种应用程序接口 (API) 的架构风格，它使用 HTTP 请求来访问和使用数据。...GraphQL 与 REST： GraphQL 和 REST API 之间的主要区别在于 GraphQL 是一种查询语言，而 REST 是一种基于网络的软件的架构概念。...可用性 REST API 使用 URI 和 HTTP 技术，这使得 API 很难预测在联系新端点时会发生什么。REST 中缺少指定的版本控制要求允许提供者采用他们自己的方法。...一些使用缓存层的客户端（Apollo Client，URQL）使用 GraphQL 的模式和类型系统，允许它们在客户端保留缓存。...与 REST API 相比，这是一个明显的区别，在 REST API 中，每个状态代码都指向某种类型的响应。

1.2K1 0

撰写合格的REST API

稍稍总结了些经验，在这篇文章里讲讲如何撰写「合格的」REST API。 RFC一致性 REST API一般用来将某种资源和允许的对资源的操作暴露给外界，使调用者能够以正确的方式操作资源。...一个合格的REST API需要根据Accept头来灵活返回合适的数据。...一般而言，如果对REST API的安全性要求比较高，那么，所有的API的所有操作均需得到授权。...其他做到了接口一致性（符合RFC）和安全性，REST API可以算得上是合格了。当然，一个实现良好的REST API还应该有如下功能： rate limiting：访问限制。...可惜python没有好的类似webmachine的实现。 Erlang/Elixir: webmachine/ewebmachine。 Ruby: webmachine-ruby。

1.8K5 0

您找到你想要的搜索结果了吗？

是的

没有找到

REST API和SOAP API之间的区别

The Representational State Transfer (REST)架构风格不是可以购买的技术，也不是可以添加到软件开发项目中的库。...REST是一种世界观，将信息提升为我们构建的体系结构的第一流元素。 Roy Fielding博士的论文“架构风格和基于网络的软件架构设计”介绍并整理了用于描述“RESTful”系统的思想和术语。...“无状态”这个术语是一个至关重要的部分，因为它允许应用程序以不一样的方式进行通信。一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求，每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。对于与RESTful API的编程交互，可以使用十几种或更多的客户端API或工具。...如果没有对RESTful架构实现的更宏观的理解，很容易失去实践的意图。 REST最好用于管理系统，通过将产生和使用它的技术产生和使用的信息解耦。

2.4K1 0

REST API和SOAP API之间的区别

大家好，又见面了，我是你们的朋友全栈君。 The Representational State Transfer (REST)架构风格不是可以购买的技术，也不是可以添加到软件开发项目中的库。...“无状态”这个术语是一个至关重要的部分，因为它允许应用程序以不一样的方式进行通信。一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求，每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。对于与RESTful API的编程交互，可以使用十几种或更多的客户端API或工具。...基于rest的请求的一个重要方面是，每个请求包含足够的状态来响应请求。这就允许服务器上的可见性和无状态性、扩展系统所需的属性以及识别正在发出的请求。这种状态还允许缓存特定的结果。...如果没有对RESTful架构实现的更宏观的理解，很容易失去实践的意图。 REST最好用于管理系统，通过将产生和使用它的技术产生和使用的信息解耦。

1.7K2 0

你确定你的 REST API 真的符合 REST 规范？

RESTful API 背后的思想是遵循REST 规范中描述的所有架构规则和限制的方式进行开发。然而，实际上，这在实践中基本上是不可能的。一方面，REST 包含了太多模糊和模棱两可的定义。...REST API 规范能做什么? 尽管存在上面说到的缺点，但使用合理的方法，REST 仍然是创建真正优秀 api 的一个绝佳选择。...因为你通过高质量的 API 规范实现的 api 将会是一致的，具有清晰的结构、良好的文档和高的单元测试覆盖率。通常，REST API规范与其文档相关联。...例如，它接受一个模型实例或一个数组，以及所需的模式，然后遍历它以构建序列化的对象。因此，假设我们需要从 API 返回博客中有帖子的所有用户，包括对这些帖子的评论。...这将使使用你的 API 的开发人员感到轻松，并且肯定比手工填写 REST API 文档模板要好。

7922 0

REST API 和 GraphQL的比较

REST（Representational State Transfer）和GraphQL是两种常见的API设计风格，各自有其独特的特点和适用场景。...在API设计方面，REST和GraphQL各有其优势和劣势。...REST（Representational State Transfer）: REST是一种基于资源的状态转移的架构风格，旨在通过操作资源的表现层（通常是JSON或XML格式）来进行通信。...下面的图表展示了REST和GraphQL的快速比较。 REST API: 架构风格：基于资源的状态转移（Representational State Transfer）。...REST在简单的场景中表现出色，而GraphQL更适用于需要更大灵活性和精确数据控制的复杂应用程序。

5281 0

优雅调试 REST API 的工具

找到一个超级漂亮同时功能超级强，还是一个 UWP 应用的调试 REST API 工具点击此地址下载安装界面截图 ?...支持对请求设置标题，同时支持分组和工作空间如我可以对访问逗比服务器添加多个不同的 API 请求 ?...我可以对一个项目的不同功能设置不同的分组，同时还可以切换工作空间不过切换空间是需要升级为专业版的当然清真的是这是一个 UWP 程序我没有收他的红包，所以不好用请到官网喷 ---- 本文会经常更新...，请阅读原文： https://blog.lindexi.com/post/%E4%BC%98%E9%9B%85%E8%B0%83%E8%AF%95-REST-API-%E7%9A%84%E5%...B7%A5%E5%85%B7.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。

1.1K1 0

聊聊Eureka Server的REST API

序本文主要研究下Eureka Server的REST API ApplicationsResource eureka-core-1.8.8-sources.jar!...replicationList) { //.... } } 这里提供一个接口 POST /{version}/peerreplication/batch 小结 eureka server的rest...api是使用javax.ws实现的。...然后spring cloud的版本，其version传的是eureka值。使用javax.ws实现的接口，感觉比起spring mvc来说，非常不好找映射，稍微有点费劲。...doc Eureka REST operations

1.7K1 0

Flink REST API 的设计指南

Flink REST API 介绍Flink REST API 是 JobManager 提供的 HTTP 接口，用户可以通过 GET、POST 等 REST 定义的方法，请求获取作业、JobManager...非阻塞的 Flink REST API 设计要点关于拓展 Flink REST API 的方法，我们可以在 Flink 官网文档、各类技术社区文章中得到详细的指引，因而这里不再赘述基础的细节，而是更侧重于讲解遇到的一些常见的问题和解决方案...→ TaskManager → 用户定义的 Task请求体、返回体设计通常对于接受 GET 方法的 REST API 而言，可以直接使用 EmptyRequestBody 类作为请求体的结构，方便快捷...但对于 POST 方法的 API，我们通常需要实现 RequestBody 接口，来定义该 REST 接口的请求体。...REST Handler 设计handler 是一个 REST API 接口的执行者，我们可以通过实现 handleRequest 方法来定义请求的处理逻辑。

1.9K2 0

Ambari 常用的 REST API 介绍

Ambari 借鉴了很多成熟分布式软件的 API 设计。 Rest API 就是一个很好地体现。通过 Ambari 的 Rest API，可以在脚本中通过 curl 维护整个集群。...并且，我们可以用 Rest API 实现一些无法在 Ambari GUI 上面做的操作。下面是一些实例。...幸运的是 Ambari 提供了 DELETE 的 Rest API，我们可以通过该 API 来删除 Ambari 中 Service。...通过这三个简单实例，就可以体会到 Ambari Rest API 的作用。...在 Rest API 的基础上，就算脱离了 WEB，我们也可以很好地控制 Ambari。当然，我们也不得不记住很多生涩的参数。

1.6K2 0

RESTful架构REST名称REST的出处RESTful API各端的具体实现

REST不是"rest"这个单词，而是几个单词缩写。 1....REST描述的是在网络中client和server的一种交互形式；REST本身不实用，实用的是如何设计 RESTful API（REST风格的网络接口）； 2....Server提供的RESTful API中，URL中只使用名词来指定资源，原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。...比如： http://api.qc.com/v1/newsfeed: 获取某人的新鲜; http://api.qc.com/v1/friends: 获取某人的好友列表; http://api.qc.com...Transfer (REST) RESTful API 为什么要用RESTful结构呢？

1.8K5 0

【API架构】REST API 设计的原则和最佳实践

这是一个完整的图表，可以轻松理解 REST API 的原理、方法和最佳实践。现在，让我们从每个盒子的原理开始详细说明它。...最佳实践现在，让我们换个角度来了解 REST 的基本最佳实践，这是每个工程师都应该知道的。保持简单和细粒度：创建模拟系统底层应用程序域或系统数据库架构的 API。...资源命名：当资源命名正确时，API 是直观且易于使用的。做得不好，同样的 API 会让人感觉很笨拙，并且难以使用和理解。RESTful API 适用于消费者。...- 输入验证：验证服务器上的所有输入。接受“已知”好的输入并拒绝错误的输入，防止 SQL 和 NoSQL 注入，将消息大小限制为字段的确切长度，服务应仅显示一般错误消息等等。...本文 https://jiagoushi.pro/principles-best-practices-rest-api-design 讨论：知识星球【首席架构师圈】或者加微信小号【cea_csa_cto

1.8K1 0

REST API URI 设计的七准则

在了解 REST API URI 设计的规则之前，让我们快速过一下我们将要讨论的一些术语。 URI REST API 使用统一资源标识符（URI）来寻址资源。...REST API 设计人员应该创建 URI，将 REST API 的资源模型传达给潜在的客户端开发人员。在这篇文章中，我将尝试为 REST API URsI 引入一套设计规则。...REST API 不应该期望有一个尾部的斜杠，并且不应该将它们包含在它们提供给客户端的链接中。...应鼓励 REST API 客户端使用 HTTP 提供的格式选择机制，即请求 header 中的 Accept 属性。...URI 的名称和结构应该向消费者传达意义。通过遵循上述规则，你将创建一个更加清晰的 REST API。这不是一个 REST 规则或约束，而是增强了 API。

1.6K4 0

Python调用REST API接口的几

相信做过自动化运维的同学都用过REST API接口来完成某些动作。API是一套成熟系统所必需的接口，可以被其他系统或脚本来调用，这也是自动化运维的必修课。...本文主要介绍python中调用REST API的几种方式，下面是python中会用到的库。...urllib2 - httplib2 - pycurl - requests urllib2 - Sample1 import urllib2, urllib github_url = 'https://api.github.com...some test repo'}) r = requests.post(github_url, data, auth=('user', '*****')) print r.json 以上几种方式都可以调用API

4.2K4 0

带有 Python REST Web 服务示例的 REST API 快速入门指南

REST 背后的主要思想是资源。您想要在 Web 应用程序中访问的所有内容都是一种资源，无论是您想要下载、更新、删除的媒体还是文档。REST 定义了一种访问、传输和修改这些资源的方法。...REST Web 服务 – 本节提供有关在 Python 中创建基本 REST Web 服务的分步说明 REST 基本概念正如 REST 的发明者 Roy Fielding 在他的研究论文中所讨论的...创建 API 端点和 REST 方法接下来，我们需要创建 api 端点和所需的 REST 方法，如下所示。 GET 方法将在文章列表中搜索请求的类别，如果找到则返回数据以及响应代码 200 OK。...def delete(self,category): 4.注册资源并分配URI 我们的最后一步是将我们的资源注册到 REST API 并为其分配一个 URI。...api.add_resource(Article, "/category/") TGS.run(debug=True,port=8080) 完整的 REST 示例程序

2.7K0 0

soapui系列|基于rest 的api测试

SoapUI是一个开源测试工具，通过soap/http来检查、调用、实现Web Service的功能/负载/符合性测试。...本文介绍基于rest的接口测试，从创建项目到编写case到断言，一步步教会你如何写一个接口测试用例。...第一节：创建要测试restapi 创建一个rest project 创建一个rest 服务创建一级资源创建二级资源创建多级资源:继续添加child resource即可第二节：根据创建好的...rest服务生成testsuit,testcase和teststep 选中最低级子资源的request右键 2.选择add to TestCase 3.创建新的testsuite...4.创建新的testcase 5.创建新的teststep 第三节：补充测试相关脚本，数据库查询，断言 1.添加断言完成设置 ----

1.1K4 0

好 RESTful API 的设计原则

做出一个好的API设计很难。API表达的是你的数据和你的数据使用者之间的契约。打破这个契约将会招致很多愤怒的邮件，和一大堆伤心的用户-因为他们手机上的App不工作了。...，多次操作得到相同的结果 URL段：在URL里面已斜杠分隔的内容数据设计与抽象规划好你的API的外观要先于开发它实际的功能。...一个好的RESTful API会在URL中包含版本信息。另一种比较常见的方案是在请求头里面保持版本信息。...同样也请注意HTTPS前缀，一个好的RESTful API总是基于HTTPS来发布的。端点一个端点就是指向特定资源或资源集合的URL。...服务器响应也是同样的键值对集，带两个回车换行符，然后是响应体。HTTP就是一个请求/响应协议；它不支持“推送”模式（服务器直接发送数据给客户端），除非你采用其他协议，如Websockets。

1.1K2 0

正确甄别API、REST API、RESTful API和Web Service之间的异同

REST API是一组关于如何构建Web应用程序API的架构规则、标准或指导，或者说REST API是遵循API原则的一种架构风格。...如果按照数学上集合的概念来解释API与REST API之间的联系与区别，API是REST API的超集，REST API 是API的子集；所有的REST API都是API，但不是所有的API都是REST...2、REST API 与RESTful API 在第一小节中，了解了什么是REST API，接下来聊聊REST API与RESTful API之间的异同。...也就是说，RESTful API是REST API的非正式实现方式，因为实现REST API的方式有很多，RESTful API只是其中一种，且没有完全满足REST API的所有设计原则，每个开发者在实现...REST API是API的一个子集，所有的REST API都是API；RESTful API是对REST API架构风格的一种非正式实现方式。

28K13 13

HDFS REST HTTP API的使用(二)HttpFS

历史文章 [hadoop3.x系列]HDFS REST HTTP API的使用(一)WebHDFS HTTPFS概述 l HttpHDFS本质上和WebHDFS是一样的，都是提供HTTP REST API...l HttpFS是一种服务器，它提供REST HTTP网关，支持所有HDFS文件系统操作(读和写)。...l HttpFS可以使用HTTP实用程序(例如curl和wget)和来自Java以外的其他语言的HTTP库Perl来访问HDFS中的数据。...l HttpFS HTTP Web服务API调用是HTTPREST调用，映射到HDFS文件系统操作。...op=LISTSTATUS&user.name=foo’ 返回HDFS的内容/user/foo目录中的JSON格式。

1.4K1 0

ReactiveCocoa实战: 模仿花瓣,重写 LeanCloud Rest Api的iOS REST Client.

这一次我们将要讨论的是移动开发中比较重要的一环--网络请求的封装.鉴于个人经验有限,本文将在一定程度上参考基于AFNetworking2.0和ReactiveCocoa2.1的iOS REST Client...,来以LeanCloud的Rest Api来练手.前两节的示例,我们都是使用自定义的PHP接口来作为测试服务器,但是真实的服务器接口是涉及到许多细节的,比如一个基本的权限控制机制,用户登录登出等.为了能更真实快速的开始网络请求类的重构...模仿 "花瓣",重写 LeanCloud Rest Api的iOS REST Client....接下来的文字,思路上将在很大程度上参考 @limboy的文章,但是会相对更加完整.另外,其实 LeanCloud 其实是有自己的iOS API的,但是是一个抽象的封装,和实际应用中使用的网络请求API有很大不同...md5 加密 LeanClodu Rest API 需要在本地对masterKey在本地做一次md5加密,我封装了一个方法,可以直接用: /** * 将字符串md5加密,并返回加密后的结果

1.2K9 0

点击加载更多

相关资讯

热门标签

活动推荐

运营活动

活动名称

广告关闭