专业 靠谱 的软件外包伙伴

您的位置:首页 > 新闻动态 > 软件外包开发Restful API设计,借鉴Google开源项目!

软件外包开发Restful API设计,借鉴Google开源项目!

2017-03-13 09:30:23

restful是一种api 风格,为什么要使用restful api?道理很简单,就是为了使api 更易用,更容易拓展。没有restful 之前,各种api 风格群魔乱舞,有了restful 之后,似乎成了一种潮流,各家大公司都默默遵守着restful api 的设计规范,就好像你的api 不是restful风格的,你都不好意思和别人打招呼。

什么样是好的restful api,可能光说理论大家很难理解。这里我们从google 的开源框架kubernetes 看一下google对restful api的理解。

从Google的开源框架看Restful API 设计

首先是get 请求。在restful api 中,每一个路径都对应着一种资源。http 的几种请求post,delete,

put,get 分别对应着对资源的增删改查。

GET 获取资源 

首先是get 请求,很容易理解,就是获取相关的数据,如上get /api/v1 获取的是api 的相关列表。

如果获取的数据是集合,就用复数的形式表示。比如

从Google的开源框架看Restful API 设计

既然路径对应着资源,那么如何设计请求参数呐?比如 /users 获取的是人的列表,如果想获取32 岁的人的列表改如何设计呐?

对于请求的参数分为三种,这里get 在restful 中,应该只使用其中两种。比如

从Google的开源框架看Restful API 设计

从Google的开源框架看Restful API 设计

在url 中的参数称为pathParameter 路径参数。没显示在url 中的,叫请求参数,比如上面的pretty,我们使用get 请求的时候是这样的:

get /api/v1/namespaces/coutomes/pods?pretty=true

举个栗子,get /stars/{star}/persons 获取某某星人的数据

如果要获取地球人的数据 get /starts/earth/persons

获取地球上男人的数据 get /starts/earth/persons?gender=male

把star 设置为路径参数,是因为star 是标识我们资源,也就是person 的位置参数。而性别gender 设置为请求参数,是因为性别是person 的一种属性。

DELETE 删除资源

从Google的开源框架看Restful API 设计

delete 与get 的设计类似,不过delete 代表的语义是删除。一般delete 的请求都是和删除数据相关的。比如删除3年二班王小明的数据 

delete /3/2/wangxiaoming

POST PUT PATCH

着三种请求放在一起,因为他们的api 设计是相同的。不同的http 语义。比如post 代表创建,create。put 代表着更新,替换。patch 就是补丁,也就是部分更新。

比如,我创建一篇博客,就该使用post。修改博客的正文内容,就使用put。至于patch 方法,我们一般是不用的,因为很多web 容器不支持。但是google 毕竟是大公司,k8s使用patch 请求的。通常情况下,有post 和put 就完全够用了。其实过去的api,连put 和delete 也不用,就用get 和post 就够了。

从Google的开源框架看Restful API 设计

从Google的开源框架看Restful API 设计

从Google的开源框架看Restful API 设计

post ,put,和patch 和get方法最明显的区别是,post,put,patch是多一个参数的,这个参数不显示在url 路径中,称为请求体。requestbody。

从Google的开源框架看Restful API 设计

这种请求,我们可以通过工具模拟。比如我想创建3年二班王小明的数据。就可以这样

从Google的开源框架看Restful API 设计

这里就是一个post 请求。请求参数为json 数据。这样就创建了一个person 的数据。名字是王小明,father 是王大明。当我们想修改数据时,比如发现,小明的爸爸其实是隔壁老王。这时,我们的请求就是

从Google的开源框架看Restful API 设计

就是这样。

 

关于:中科研拓

深圳市中科研拓科技有限公司专注提供软件外包、app开发、智能硬件开发、O2O电商平台、手机应用程序、大数据系统、物联网项目等开发外包服务,通过IT技术实现创造客户和社会的价值,成为优秀的软件公司,通过客户需求导向、开放式创新、卓越运营管理等战略的实施,全面打造公司的核心竞争力。优秀软件外包公司、软件开发公司,联系电话400-0316-532,邮箱sales@zhongkerd.com,网址www.zhongkerd.com


  上一篇   [返回首页] [打印] [返回上页]   下一篇