Restful API 原理以及实现

转载 2015年11月18日 16:25:49

先说说API

再说啥是RESRFUL API之前,咱先说说啥是API吧。API大家应该都知道吧,简称接口嘛。随着现在移动互联网的火爆,手机软件,也就是APP几乎快爆棚了。几乎任何一个网站或者应用都会出一款iOS或者Android APP,相比网页版的体验,APP确实各方面性能要好很多。

那么现在问题来了。比如QQ空间网站,如果我想获取一个用户发的说说列表。

QQ空间网站里面需要这个功能。
Andoid APP里面也需要这个功能。
iOS APP里面也需要这个功能。

现在就有三套,那么按照传统的开发网站的结构,你就要写3套获取用户说说列表的功能。也就是需要在3个地方都写连接mysql,查询mysql,可想而知是非常浪费时间和经历的,而且安全性能很差,你可以想象你把连接mysql的配置写在Android里面,是多么危险的一件事情。人家破解出来分分钟。

所以!当当当当! API 就诞生了~

API就是为了解决这种情况而诞生,由一个地方统一提供API接口,哪个平台想使用就直接调用这个API接口来或许信息就可以了。

比如:获取QQ空间用户发的说说列表:

QQ Zone web: https://api.qzone.com/user/getUserFeedList?from=web
QQ Zone Android: https://api.qzone.com/user/getUserFeedList?from=android
QQ Zone iOS: https://api.qzone.com/user/getUserFeedList?from=ios

你看。我就写了一次代码接口。就可以供3个地方同时使用,我仅仅是用了from参数加以区别,可能每个平台想要的数据不一样。

这样不仅更加安全,快捷,最主要是分工更快速了。一个人专门写接口,另外一个人只需要知道如何调用就可以了,完全不需要知道是如何实现的。

RESTFUL API

上面简单的说了API 的由来以及使用API带来的好处,好东西大家一用就会出问题,就像PHP一样,用的人一多就会出现各种不同的规范,API也一样,虽然都是调用API,但是,写法却千差万别,维护起来很是麻烦,比如:同样是调用QQ空间用户说说列表,就可能有以下好几种写法:

https://api.qzone.com/user/getUserFeedList?from=web
https://api.qzone.com?m=user&c=getUserFeedList?from=web
https://qzone.com/api/user/getUserFeedList?from=web
https://qzone.com?m=api&c=user&a=getUserFeedList?from=web

你看,看上去千差万别,各种状况都有,后期维护是个大问题,再就是请求方式也不对,有些喜欢用POST ,然后所有的请求都是POST, 有些喜欢用GET ,不管多大的数据量都用GET去请求,可想而知,全都乱了套。

那么有没有一个行业标准来规范和约束这些具体的东西呢?或者说是实施的比较好的?当然有。RESTFUL API的结构设计就诞生了。

REST 意思是:表述性状态传递(英文:Representational State Transfer)

参考资料:
RESTful API 设计最佳实践
RESTful API 设计指南

https://www.zybuluo.com/phper/note/79184

RESTful API的理解

什么是REST,RESTful API?
  • wangyanchao000
  • wangyanchao000
  • 2017年02月13日 13:49
  • 26095

REST与RESTFul API最佳实践

我经常会面试一些做PHP的开发者,让我很奇怪的是,10个人总有8个多不知道什么是REST服务,甚至是没有听说过。但RESTFul API已经是现在互联网里对外开放接口的主流模式,可参考: 豆瓣A...
  • u013063153
  • u013063153
  • 2017年05月30日 21:39
  • 3816

RESTful api接口规范

整体规范建议采用RESTful 方式来实施。   协议 API与用户的通信协议,总是使用HTTPs协议,确保交互数据的传输安全。   域名 应该尽量将API部署在专用域名之下。 https://api...
  • u010622769
  • u010622769
  • 2017年01月11日 10:40
  • 7949

对RESTful Web API的理解与设计思路

距离上一篇关于Web API的文章(如何实现RESTful Web API的身份验证)有好些时间了,在那篇文章中提到的方法是非常简单而有效的,我在实际的项目中就这么用了,代码经过一段时间的磨合,已经很...
  • dyllove98
  • dyllove98
  • 2013年03月06日 21:56
  • 13159

如何实现RESTful Web API的身份验证

最近想拿一个小项目来试水RESTful Web API,项目只有几个调用,比较简单,但同样需要身份验证,如果是传统的网站的话,那不用说,肯定是用户名+密码在登录页获得登录Token,并把登录Token...
  • u014386474
  • u014386474
  • 2016年06月21日 16:05
  • 1711

RESTful API知识整理

不是标准,是设计风格REST(英文:Representational State Transfer,简称REST),通常应用在web应用程序中,提供一套满足特定的约束和原则的接口,用于客户端和服务器交...
  • pony_maggie
  • pony_maggie
  • 2017年01月29日 16:41
  • 1868

Django REST Framework v.3官方中文教程 索引

注意:这是版本v.3+的REST framework文档。 Django REST framework 是一个强大且灵活的工具包,用以构建Web APIs。 为什么要使用REST framewor...
  • ppppfly
  • ppppfly
  • 2016年04月07日 02:41
  • 26784

我的理解 RESTful Api 架构

不要以为 RESTful Api 就是设计得像便于 SEO 的伪静态,例如一个 Api 的 URL 类似于 http://xxx.com/blog/1 ,我们可以通过浏览器访问该 URL 而读取文章...
  • onemetre
  • onemetre
  • 2016年02月19日 09:00
  • 1158

如何设计好的RESTful API 之好的RESTful API 特征

导读:设计好RESTful API对于软件架构的可扩展性、可伸缩性和消费者的体验都具有至关重要的作用。本次虚拟研讨会的主题是,如何设计好的RESTful API。 关键词:RESTful API R...
  • ywk253100
  • ywk253100
  • 2014年05月12日 21:31
  • 2090

WebService为什么不如RESTful API流行

1 WebService有很多协议,为什么HTTP比较流行? WebService是个很重型的规范,它的应用协议是SOAP(简单对象访问协议),它所依赖的下层通信方式不单单是HTTP,也有SOA...
  • baolin811
  • baolin811
  • 2015年08月20日 23:27
  • 7577
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Restful API 原理以及实现
举报原因:
原因补充:

(最多只允许输入30个字)