Flowable入门系列文章91 - 一般可流动的REST原则 02

Posted 2022-01-10 分享牛

1、方法和返回码

表1. HTTP方法和相应的操作

方法	操作
GET	获取单个资源或获取资源的集合。
POST	创建一个新的资源。还用于执行具有太复杂的请求结构以适应GET请求的查询URL的资源查询。
PUT	更新现有资源的属性。也用于调用现有资源上的操作。
DELETE	删除现有的资源。

表2. HTTP方法响应代码

响应	描述
200 - Ok	操作成功，并且已经返回了响应（GET和PUT请求）。
201 - Created	操作成功，实体已经创建，并在响应主体（POST请求）中返回。
204 - No content	操作成功，实体已被删除，因此没有返回响应体（DELETE请求）。
401 - Unauthorized	操作失败。该操作需要设置验证标题。如果请求中包含此信息，则提供的凭据无效或用户无权执行此操作。
403 - Forbidden	该操作是禁止的，不应该重新尝试。这并不意味着身份验证不授权的问题，这是一个不允许的操作。示例：不管用户或进程/任务状态如何，删除作为运行进程一部分的任务都是不允许的，并且将永远不会被允许。
404 - Not found	操作失败。未找到请求的资源。
405 - Method not allowed	操作失败。此资源不允许使用此方法。例如，尝试更新（PUT）部署资源将导致405状态。
409 - Conflict	操作失败。该操作会导致更新由另一个操作更新的资源，从而使更新不再有效。还可以指示在具有该标识符的资源已经存在的集合中正在创建的资源。
415 - Unsupported Media Type	操作失败。请求主体包含不受支持的媒体类型。当请求主体JSON包含一个未知的属性或值没有被接受的正确格式/类型时也会发生。
500 - Internal server error	操作失败。执行操作时发生意外的异常。esponse-body包含有关错误的详细信息。

application/json除非请求二进制内容（例如，部署资源数据），否则HTTP响应的媒体类型总是使用内容的媒体类型。

2、错误响应正文

发生错误时（客户端和服务器，4XX和5XX状态码）响应主体包含描述发生的错误的对象。未找到任务时的404状态示例：

"statusCode" : 404,
"errorMessage" : "Could not find a task with id '444'."

上面文章来自盘古BPM研究院：http://vue.pangubpm.com/
文章翻译提交：https://github.com/qiudaoke/flowable-userguide
了解更多文章可以关注微信公众号：