首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往
您找到你想要的搜索结果了吗?
是的
没有找到

这次我让你彻底弄懂 RESTful

HTTP的提供了很多动词:GET、PUT、POST、DELETE...... 这些动词都是有含义的。 比如 GET 就是获取资源,是查询请求。 PUT 指的是修改资源,是幂等的。...所以根据这些规范我们都能得知这次交互的一些动作,所以 RESTful 风格正确的使用姿势如下: 比如获取一个 user。 错误姿势:GET /getUserById?userId=1。...正确姿势:GET /users/1。 再比如新增 user。 错误姿势:POST /addUser (省略body)。 正确姿势:POST /users (省略body)。...协议其实就是约定好的一个东西,协议就规定 GET 是获取资源,那你非得在 URL 上再重复一遍或者所有请求不论增删改都用 GET 这个动作,这其实就是没有完全遵循这个协议。...例子我就不自己编了,抄一下 stackoverflow 回答上的例子。

52430

Restful API实现乐观锁,应返回409还是412?

近些年Restful API变得很流行,一个重要的原因是其充分利用HTTP协议标准,这样API Consumer消费Restful API的成本就小很多,API开发人员也更加有据可循。...Restful API复用HTTP协议的方法和状态码来指代不同的行为,比如POST代表创建一条资源,创建成功用201表示,请求校验失败用400表示;GET代表获取一条或多条资源,获取成功用200表示;DELETE...这里讨论一个问题,对于Restful API的PUT操作,在并发环境下,两个Request更新同一条资源,可能会出现更新内容丢失的情况。针对这个问题,通常可以“加锁”来解决,那么加什么锁呢?...110; 如果是加悲观锁的话,就是在执行第一条select语句时加一个排他锁(select for update),在update语句执行完了才释放锁,这样两个PUT请求只能一个先执行一个后执行,就不会出现更新内容丢失的情况...References https://stackoverflow.com/questions/3620203/http-status-412-precondition-failed-and-database-versioning

98510

怎样编写好的 API?

REST 建议 GET 方法只能用来获取数据,所以在上面的集合中,它是唯一一个安全的方法。不管你调用多少次基于 REST 的 GET 方法,它永远不会改变数据库中的任何东西。...错误 / 异常处理 我对自己使用的 API 的基本期望之一就是,需要有一种明确的方式来判断是否有错误或异常。我想要知道请求是否得到了处理。 HTTP 有一种简单的方式来实现这一点:HTTP 状态码。...例如,客户端发送了一些内容到服务器端,但是这非法的请求,而我们的校验是有缺陷的,从而导致这个问题继续在代码中执行了下去,最终导致出现了异常,这样就会返回一个 5xx 的状态码。...例如,注释与代码的脱节。当代码发生变化的时候,注释依然保持不变,这样的话,注释就过时了。这甚至会比根本就没有任何注释更糟糕,因为在随后的一段时间内,它们会提供错误的信息。...注释不会自动更新,所以开发人员需要记得在维护代码的时候同时维护它们。 自更新的文档工具可以解决这个问题。

60120

一些开发规则

不可出现版本号、文件名、档目录信息。 合并后的分支应删除。 Commit 基本原则 一个功能commit一次,应同时修改更新日志。...资料表变动或者较大调整升中版号 1.0.0=>1.1.0 重大变动或架构调整升大版号 1.0.0=>2.0.0 删除原则 版号过多时可删除非重要版号 应至少保留每个中版号的最新一版 应至少保留最近更新的十个版号 Restful...即使不会发生错误,程序代码英文大小写也需明确区分。 我自己的标准是: 绝对不可使用没有意义的命名。...附加表 类型 面向对象中动词使用 数据库 METHOD(restful) 增-CREATE add/create INSERT GET 查-READ get/list SELECT POST 改-UPDATE...不要出现错别字与错误的标点符号 英文数字或字符需要与中文字符隔一个空格 一定要注意排版,排版必须整洁,突出重点。且内容无重复、多余的部分,也不能出现与文档无关的内容。

20810

RESTfulRESTful API 接口设计规范 | 示例

使用RESTful 设计RESTful API 资源路径(URI):RESTful的核心是面向资源,如何规划资源路径很重要 HTTP动词(请求方式):如get,post,delete,put...返回结果:如POST资源的时候,需要返回一个资源实例;GET资源列表时,需要返回一个资源数组; 资源路径 在RESTful架构中,每个网址代表一个资源,所以网址中不能有动词,只能有名词。...一般而言,返回的信息中将error作为键名,出错信息作为键值即可,例如: { "error":"参数错误" } 返回结果 针对不同操作(如GET,POST),服务器向用户返回的结果应该符合以下规范:...环境集成包 XAMPP 或 upupw 添加虚拟主机,以及取消跨站目录限制 httpd-vhosts.conf文件中 找到添加的域名,将php_admin_value xxx这句开头加入井号进行注释...(参考:http://graphql.cn/ ) 参考 慕课教程 Restful API 的设计规范 理解RESTful架构 RESTful架构基础

1.2K20

SpringBoot 之Actuator.

一、Actuator 介绍     Actuator 是 SpringBoot 项目中一个非常强大一个功能,有助于对应用程序进行监视和管理,通过 restful api 请求来监管、审计、收集应用的运行情况...如下: Operation HTTP method @ReadOperation GET @WriteOperation POST @DeleteOperation DELETE     Endpoint...参数默认是必需的,可以通过使用 @Nullable 注释使其成为可选的。     可以通过使用 @Selector 注释操作方法的一个或多个参数来进一步定制路径。...原来我给的参数名是 path,原来我设想我可以访问 /actuator/my/[任意字符] 的路径,但是会报 400 参数不匹配错误。但是嘞,/actuator/my/[任意字符]?...这个是 stackoverflow 上的一个解释~ org.apache.maven.plugins

87550
领券