首页
学习
活动
专区
圈层
工具
发布

用ASP.NET Core 2.0 建立规范的 REST API -- GET 和 POST

html 本文介绍的是使用ASP.NET Core建立Richardson成熟度为2级的伪RESTful web API, 本文介绍的是GET和POST....例如: api/getusers 就是不正确的. GET api/users 就是正确的 GET api/users/{userId}. 所以资源应该使用的是名词....,表示请求的资源不存在 405 - Method not allowed,这就是当我们尝试发送请求给某个资源时,使用的HTTP方法却是不允许的,例如使用POST api/countries, 而该资源只实现了...GET,所以POST不被允许 406 - Not acceptable,这里涉及到了media type,例如API消费者请求的是application/xml格式的media type,而API只支持...OK 如果POST到单个资源的地址 如果POST到这个地址 http://localhost:5000/api/countries/{id},  那么, 如果该id的资源不存在, 则应该返回404; 如果该

2.1K10
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    REST API和SOAP API之间的区别

    这是最常见的请求,每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。 对于与RESTful API的编程交互,可以使用十几种或更多的客户端API或工具。...当由于技术、组织或过程复杂性而不能在单个事务的范围内维护请求的生命周期时,SOAP是最佳的利用方式。 Verbs ? 谓词是可以与服务器上的资源交互的方法或操作。...总是会有特定于应用程序的行为,但是我们越能深入到非特定于应用程序的行为中,我们的系统就会越有弹性、更容易访问和更容易维护。 POST 当客户端无法预测要创建的资源的标识时,将使用POST。...它们返回的不是201,而是创建了资源主体的200。这似乎是避免第二个请求的快捷方式,但它结合了POST和GET函数,同时增加了缓存资源的可能性。避免以牺牲大局为代价而走捷径的冲动。...注意:此协议级别的处理并不一定排除需要更高(应用程序级别)的事务处理,在体系结构上,它是希望在应用程序级别以下进行处理的属性。 DELETE DELETE在公共Web上没有广泛使用(谢天谢地!)

    2.8K10

    REST API和SOAP API之间的区别

    这是最常见的请求,每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。 对于与RESTful API的编程交互,可以使用十几种或更多的客户端API或工具。...当由于技术、组织或过程复杂性而不能在单个事务的范围内维护请求的生命周期时,SOAP是最佳的利用方式。 Verbs 谓词是可以与服务器上的资源交互的方法或操作。...总是会有特定于应用程序的行为,但是我们越能深入到非特定于应用程序的行为中,我们的系统就会越有弹性、更容易访问和更容易维护。 POST 当客户端无法预测要创建的资源的标识时,将使用POST。...它们返回的不是201,而是创建了资源主体的200。这似乎是避免第二个请求的快捷方式,但它结合了POST和GET函数,同时增加了缓存资源的可能性。避免以牺牲大局为代价而走捷径的冲动。...注意:此协议级别的处理并不一定排除需要更高(应用程序级别)的事务处理,在体系结构上,它是希望在应用程序级别以下进行处理的属性。 DELETE DELETE在公共Web上没有广泛使用(谢天谢地!)

    2.1K20

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

    RESTful API 背后的思想是遵循REST 规范中描述的所有架构规则和限制的方式进行开发。然而,实际上,这在实践中基本上是不可能的。 一方面,REST 包含了太多模糊和模棱两可的定义。...REST API 规范能做什么? 尽管存在上面说到的缺点,但使用合理的方法,REST 仍然是创建真正优秀 api 的一个绝佳选择。...因为你通过高质量的 API 规范实现的 api 将会是一致的,具有清晰的结构、良好的文档和高的单元测试覆盖率。 通常,REST API规范与其文档相关联。...API 项目中使用,还可以在客户端应用程序项目中使用,以描述与 API 一起工作的函数中的类型。...这将使使用你的 API 的开发人员感到轻松,并且肯定比手工填写 REST API 文档模板要好。

    1.6K20

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

    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 方法来定义请求的处理逻辑。

    2.2K20

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

    这是一个完整的图表,可以轻松理解 REST API 的原理、方法和最佳实践。 现在,让我们从每个盒子的原理开始详细说明它。...REST 定义了四个接口约束:资源的识别、通过表示的资源操作、自描述消息和作为应用程序状态引擎的超媒体。 自描述消息:每条消息都包含足够的信息来描述如何处理消息。...最佳实践 现在,让我们换个角度来了解 REST 的基本最佳实践,这是每个工程师都应该知道的。 保持简单和细粒度:创建模拟系统底层应用程序域或系统数据库架构的 API。...资源命名:当资源命名正确时,API 是直观且易于使用的。做得不好,同样的 API 会让人感觉很笨拙,并且难以使用和理解。RESTful API 适用于消费者。...本文 https://jiagoushi.pro/principles-best-practices-rest-api-design 讨论:知识星球【首席架构师圈】或者加微信小号【cea_csa_cto

    2.1K10

    REST API URI 设计的七准则

    在了解 REST API URI 设计的规则之前,让我们快速过一下我们将要讨论的一些术语。 URI REST API 使用统一资源标识符(URI)来寻址资源。...REST API 设计人员应该创建 URI,将 REST API 的资源模型传达给潜在的客户端开发人员。在这篇文章中,我将尝试为 REST API URsI 引入一套设计规则。...REST API 不应该期望有一个尾部的斜杠,并且不应该将它们包含在它们提供给客户端的链接中。...例如: http://api.example.com/blogs/guy-levin/posts/this-is-my-first-post 规则#4:不得在 URI 中使用下划线(_) 文本查看器(...URI 的名称和结构应该向消费者传达意义。通过遵循上述规则,你将创建一个更加清晰的 REST API。这不是一个 REST 规则或约束,而是增强了 API。

    1.9K40

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

    分层系统 分层系统方法指出Web 服务应该遵循分层方法,即我们应该将我们的Web 服务划分到不同的层中,这些层不能超越它们的直接层,例如身份验证层、数据访问层、消息处理器层。...创建 API 端点和 REST 方法 接下来,我们需要创建 api 端点和所需的 REST 方法,如下所示。 GET 方法将在文章列表中搜索请求的类别,如果找到则返回数据以及响应代码 200 OK。...否则 404 未找到 class Article(Resource): def get(self, category): POST 方法将在文章列表中插入新的文章数据,并返回插入的数据并创建响应代码...def delete(self,category): 4.注册资源并分配URI 我们的最后一步是将我们的资源注册到 REST API 并为其分配一个 URI。...api.add_resource(Article, "/category/") TGS.run(debug=True,port=8080) 完整的 REST 示例程序

    3.2K00

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

    REST架构遵循CRUD原则,所有的资源都可以通过GET、POST、PUT和DELETE这四种行为完成对应的操作。...如果按照数学上集合的概念来解释API与REST API之间的联系与区别,API是REST API的超集,REST API 是API的子集;所有的REST API都是API,但不是所有的API都是REST...学生管理API的使用者调用的API如下: 1、创建学生资源:[POST] http://www.example.com/student 2、获取所有学生资源:[GET] http://www.example.com...因为在RESTful API的设计中,我们完全可以通过GET的方式完成CURD操作,也可以通过DELETE行为来创建资源,通过POST行为来修改资源,它的实现方式并不严谨或者说并没有严格按照REST API...REST API是API的一个子集,所有的REST API都是API;RESTful API是对REST API架构风格的一种非正式实现方式。

    29K1313
    领券