RestfulAPI的示例分析
这篇文章将为大家详细讲解有关Restful API的示例分析,小编觉得挺实用的,因此分享给大家做个参考,希望大家阅读完这篇文章后可以有所收获。
成都网站制作、成都做网站的开发,更需要了解用户,从用户角度来建设网站,获得较好的用户体验。创新互联建站多年互联网经验,见的多,沟通容易、能帮助客户提出的运营建议。作为成都一家网络公司,打造的就是网站建设产品直销的概念。选择创新互联建站,不只是建站,我们把建站作为产品,不断的更新、完善,让每位来访用户感受到浩方产品的价值服务。
Restful:
本质:一种软件架构风格
核心:面向资源
解决的问题:降低开发的复杂性,提高系统的可伸缩性
设计概念和准则:
网络上的所有事物都可以被抽象为资源
每一个资源都有唯一的资源标识,对资源的操作不会改变这些标识
所有的操作都是无状态的
HTTP协议:
URL:port[服务器端口,默认为80],path[访问资源的路径],query-string[发送给http服务器的数据],anchor[锚]
请求:组成格式[请求行、消息报头、请求正文]
请求行:格式[Method Request-URI HTTP-Version CRLF],举例[GET / HTTP/1.1 CRLF]
请求方法:GET、POST、HEAD、PUT、DELETE、OPTIONS
响应:组成格式[状态行、消息报头、响应正文]
状态行:格式[HTTP-Version Status-Code Reason-Phrase CRLF],举例[HTTP/1.1 200 OK]
常用状态码:200 OK,400 Bad Request,401 Unauthorized,404 Not Found,500 Internal Server Error,503 Server Unavailable
Restful API(六要素):
资源路径(URI):在Restfull架构中,每个网址代码一种资源,所以网址中不能有动词,只能有名词。一般来说API中的名词应该使用复数。
HTTP动词:对于资源的操作(CURD),由HTTP动词(谓词)表示。
GET[从服务器取出资源(一项或多项)]
POST[在服务器新建一个资源]
PUT[在服务器更新资源(客户端提供改变后的完整资源)]
PATCH[在服务器更新资源(客户端提供改变的属性)]
DELETE[从服务器删除资源]
过滤信息:如果记录数量很多,服务器不可能都将它们返回给用户。API应该提供参数,过滤返回结果。
状态码:服务器向用户返回的状态码和提示信息,使用标准HTTP状态码。
200 OK 服务器成功返回用户请求的数据,该操作是幂等的
201 CREATED 新建或修改数据成功
204 NO CONTENT 删除数据成功
400 BAD REQUEST 用户发出的请求有错误,该操作是幂等的
401 Unauthorized 表示用户没有认证,无法进行当前操作
403 Forbidden 表示用户访问是被禁止的
错误处理:如果状态码是4XX或者5XX,就应该向用户返回出错信息。一般来说,返回的信息中将error作为键名,出错信息作为键值即可。
{"error": "参数错误"}
返回结果:针对不同操作,服务器向用户返回的结果应该符合以下规范
GET /collections[返回资源对象的列表(数组)]
GET /collections/identity[返回单个资源对象]
POST /collections[返回新生成的资源对象]
PUT /collections/identity[返回完整的资源对象]
PATCH /collections/identity[返回被修改的属性]
DELETE /collections/identity[返回一个空文档]
关于“Restful API的示例分析”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,使各位可以学到更多知识,如果觉得文章不错,请把它分享出去让更多的人看到。
分享题目:RestfulAPI的示例分析
网页链接:http://cdiso.cn/article/ipcdjj.html