标签：常用 service min comm 如何 客户端 conflict ima str
含义：
HTTP Methods 一共有九个，分别是 GET，HEAD，POST，PUT，DELETE，TRACE，OPTIONS，CONNECT，PATCH
RESTful API 设计中，常用的有POST，GET，PUT，PATCH 和 DELETE,分别对应对资源的创建，获取，修改，部分修改和删除操作。
Methods的用途和返回值约定
| HTTP Methods | 操作方式（CRUD） | 获取多个资源（/books）返回结果 |获取单个资源(/books/id) 返回结果
/books?page=3 | 200 (OK)<br />在Body中返回对应id的book<br /><br />404 (Not Found) <br />如果没有对应数据，或者id格式不对 |https://api.server.com/books注意：POST API 不是一个数据安全和幂等性操作，如果客户端多次调用同样的 API 会导致多条数据被创建，这些数据除了 ID 不同其他属性都相同。
举例：
POST https://api.server.com/books
POST https://api.server.com/books/123456/comments
GET
一般用于读取数据，即获取资源。成功调用 GET API 会返回相应的数据。如果请求的数据不存在可返回404（Not Found）或者由于参数不正确的原因可以返回400（Bad Request）
如果客户端只请求一条数据 GET https://api.server.com/books/000，应该返回对应ID的数据即可：
注意：GET操作是数据安全和具有幂等性的操作，也就是多次调用GET应该返回相同的数据（期间没有修改操作的前提下），并且不会导致任何数据的破坏性修改。
API举例：
GET https://api.server.com/books/123456 GET https://api.server.com/books/123456/comments GET https://api.server.com/books/123456/comments/id001 GET https://api.server.com/books?author=gause 客户端调用：POST 调用方式几乎相同，比如要修改的数据是{id: "book-id-000", title: "Are your lights on", author: "Donald C. Gause"}客户端发送 HTTP PUT 请求到https://api.server.com/books。和POST不同的是，该操作会带上数据的 UID，用来定位具体要修改的这一条数据，方便后续操作。也有的设计会把ID放在URL中https://api.server.com/books/book-id-000，这样要修改的Body中的数据可以不用包含ID
服务端实现：如果更新成功 PUT API 应该返回200。如果 PUT 请求的 body 中没有任何信息则返回204, 如果id没有找到或id格式不正确，返回404。和POST不同的是该 API 没有必要在Header中更新刚创建数据ID URL，因为我们是在修改该条数据，其 ID 之前已经被客户的获取。
PUT https://api.server.com/books/123456/comments/id001 {title: "Are your lights on"} 只包含部分要修改的数据HTTP Methods 和 RESTful Service API 设计
标签：常用 service min comm 如何 客户端 conflict ima str
原文地址：https://www.cnblogs.com/catherine9192/p/9081527.html
