首页
学习
活动
专区
圈层
工具
发布
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    十个书写Node.js REST API的最佳实践(上)

    原文:10 Best Practices for Writing Node.js REST APIs 我们会通过本文介绍下书写Node.js REST API的最佳实践,包括各个主题,像是命名路由、认证...对于Node.js来说最流行的一个用例就是用其来书写RESTful API。尽管如此,当我们使用监控工具来帮助用户排查问题时,我们总是能感受到在REST API上开发者们有很多的问题。...我希望这些最佳实践能够对你有所帮助。 1. 使用HTTP方法和API路由 设想一下你正在构建Node.js RESTful API用以用来创建、更新、获取或者删除用户。...这一检查是为了保护嵌入机免受拒绝服务攻击,这一攻击里攻击者可以给我们发送一个没有结尾的header,这会导致嵌入机一直缓冲” 来自 Node.js HTTP 解析器 4 为你的Node.js REST...接下篇《十个书写Node.js REST API的最佳实践(下)》

    2.5K00

    十个书写Node.js REST API的最佳实践(下)

    接 《十个书写Node.js REST API的最佳实践(上)》 5. 对你的Node.js REST API进行黑盒测试 测试你的REST API最好的方法之一就是把它们当成黑盒对待。...译者注:mock 和 stub 都是测试的方法 有个可以帮你进行Node.js REST API进行黑盒测试的模块叫做supertest。...创建合适的API文档 你书写API,这样其他人就可以使用它们,并从中收益。给你的Node.js Rest API提供API文档是很重要的。...——在这里了解跟多 令人惊讶的REST API,激发你的灵感 如果你正准备开始开发Node.js REST API或者给一个旧的项目开发新版本,我们在这里精心挑选了四个值得check out的真实案例...GitHub API Twilio API Stripe API DigitalOcean API 我希望现在你对怎么使用Node.js书写API有一个更好的认知。

    2.5K00

    撰写合格的REST API

    两周前因为公司一次裁人,好几个人的活都被按在了我头上,这其中的一大部分是一系列REST API,撰写者号称基本完成,我测试了一下,发现尽管从功能的角度来说,这些API实现了spec的显式要求,但是从实际使用的角度...仔细研究了原作者的代码,发现缺失的东西实在太多,每个API基本都在各自为战,与其修补,不如重写(并非是程序员相轻的缘故),于是我花了一整周,重写了所有的API。...稍稍总结了些经验,在这篇文章里讲讲如何撰写「合格的」REST API。 RFC一致性 REST API一般用来将某种资源和允许的对资源的操作暴露给外界,使调用者能够以正确的方式操作资源。...一般而言,如果对REST API的安全性要求比较高,那么,所有的API的所有操作均需得到授权。...使用HMAC可以很大程度上防止DOS攻击 —— 无效的请求在验证HMAC阶段就被丢弃,最大程度保护服务器的计算资源。

    1.8K50

    REST风格的应用程序实现

    莫笑我老土,因为我确实是最近才听说REST风格的,以前就是觉得 /category/product/pid 这样的地址非常的漂亮,但是那只是表象罢了,了解深入以后,发现必须有一个客户端的Ajax Engine...和Server端的服务配合,才能实现一个REST风格的应用,下面就是我的实验。...服务器端的服务可能会被众多的浏览器请求,也可能被第三方应用程序所调用,所以需要从总体上来考虑这个对外的“应用程序接口”(API),尽量保持接口的稳定性。...REST就是考虑了这些因素,可以使用RESTful API来实现上面的服务。 RESTful 原则介绍 REST的主要原则有: 用URL表示资源。...数据必须符合要求的格式 在PHP的程序中,想要实现这种REST风格的URL,仅仅依靠程序是不行的,还需要在服务器端配置rewrite规则,例如,对于一个REST风格的资源请求: http://www.api.com

    43010

    REST API和SOAP API之间的区别

    The Representational State Transfer (REST)架构风格不是可以购买的技术,也不是可以添加到软件开发项目中的库。...“无状态”这个术语是一个至关重要的部分,因为它允许应用程序以不一样的方式进行通信。 一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求,每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。 对于与RESTful API的编程交互,可以使用十几种或更多的客户端API或工具。...通过设置一个保护模型,该模型要求用户进行身份验证并证明他们可以在我们给他们许可之前做一些事情。 What About SOAP? 简单明了,它们不是一回事。...总是会有特定于应用程序的行为,但是我们越能深入到非特定于应用程序的行为中,我们的系统就会越有弹性、更容易访问和更容易维护。 POST 当客户端无法预测要创建的资源的标识时,将使用POST。

    2.4K10

    REST API和SOAP API之间的区别

    大家好,又见面了,我是你们的朋友全栈君。 The Representational State Transfer (REST)架构风格不是可以购买的技术,也不是可以添加到软件开发项目中的库。...“无状态”这个术语是一个至关重要的部分,因为它允许应用程序以不一样的方式进行通信。 一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求,每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。 对于与RESTful API的编程交互,可以使用十几种或更多的客户端API或工具。...通过设置一个保护模型,该模型要求用户进行身份验证并证明他们可以在我们给他们许可之前做一些事情。 What About SOAP? 简单明了,它们不是一回事。...总是会有特定于应用程序的行为,但是我们越能深入到非特定于应用程序的行为中,我们的系统就会越有弹性、更容易访问和更容易维护。 POST 当客户端无法预测要创建的资源的标识时,将使用POST。

    1.7K20

    优雅调试 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.1K10

    REST API 和 GraphQL的比较

    REST(Representational State Transfer)和GraphQL是两种常见的API设计风格,各自有其独特的特点和适用场景。...下面的图表展示了REST和GraphQL的快速比较。 REST API: 架构风格: 基于资源的状态转移(Representational State Transfer)。...选择取决于需求: REST适用于: 具有简单结构的应用程序。 需要充分利用HTTP缓存的场景。 已有广泛接受的标准和约定。 GraphQL适用于: 需要灵活性和精确控制数据的应用程序。...面向移动设备和慢速网络的应用程序。 结论: 选择REST还是GraphQL取决于项目的具体需求和复杂性。...REST在简单的场景中表现出色,而GraphQL更适用于需要更大灵活性和精确数据控制的复杂应用程序。

    52410

    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.9K20

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

    RESTful API 的存在是 web 开发历史上的一个里程碑。在本文中,我将和你探讨几种节省 REST API 开发时间的方法,并给出相关的 Node.js 示例。...例如,对于在移动应用程序中使用的实际 api,原子资源的使用是次优的。再如,完全拒绝请求之间的数据存储实质上禁止了随处可见的“用户会话”机制。 不过,我想说,也没你想的那么糟糕!...REST API 规范能做什么? 尽管存在上面说到的缺点,但使用合理的方法,REST 仍然是创建真正优秀 api 的一个绝佳选择。...但,这些服务对我来说是不方便的,因为需要快速编辑规范并将其与代码更改对齐。 Tinyspec 规范 在本文中,我将使用基于 tinyspec 规范定义 API。...API 项目中使用,还可以在客户端应用程序项目中使用,以描述与 API 一起工作的函数中的类型。

    79020

    REST API URI 设计的七准则

    在了解 REST API URI 设计的规则之前,让我们快速过一下我们将要讨论的一些术语。 URI REST API 使用统一资源标识符(URI)来寻址资源。...REST API 设计人员应该创建 URI,将 REST API 的资源模型传达给潜在的客户端开发人员。在这篇文章中,我将尝试为 REST API URsI 引入一套设计规则。...REST API 不应该期望有一个尾部的斜杠,并且不应该将它们包含在它们提供给客户端的链接中。...根据应用程序的字体,下划线(_)字符可能被这个下划线部分地遮蔽或完全隐藏。...URI 的名称和结构应该向消费者传达意义。通过遵循上述规则,你将创建一个更加清晰的 REST API。这不是一个 REST 规则或约束,而是增强了 API。

    1.6K40

    在基于Node.js的微服务应用程序中实现API网关模式

    微服务提供增强的可扩展性、灵活性和敏捷性。 随着组织采用基于微服务的应用程序,管理这些服务的多种和分布式性质变得越来越具有挑战性。...API 网关简化了客户端实现,增强了安全性,并优化了基于微服务的系统中的通信。 API 网关模式有哪些优势? 使用 API 网关模式为应用程序提供了许多好处。...方法 01:基于容器的实现(使用 Kubernetes 或 Docker) 让我们看看如何在 Docker 环境中实现和部署 API 网关模式。 首先,我为我的应用程序创建了以下文件夹和文件结构。...mkdir api-gateway cd api-gateway 初始化新的 Node.js 项目。 npm init -y 安装需要的依赖项。...来将 Node.js 应用程序容器化。

    62910
    领券