首页
学习
活动
专区
圈层
工具
发布

如何设计restful风格接口

restful风格接口 URL定位资源,用HTTP动词(GET,POST,DELETE,DETC)描述操作。...看Url就知道要什么 看http method就知道干什么 看http status code就知道结果如何 1....REST描述的是在网络中client和server的一种交互形式;REST本身不实用,实用的是如何设计 RESTful API(REST风格的网络接口); 2....Server提供的RESTful API中,URL中只使用名词来指定资源,原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。...怎么用RESTful 1、每个资源使用2个URL,网址中只能有名词 2、对于资源的操作类型由HTTP动词来表示 3、统一的返回结果 4、返回正确的状态码 5、允许通过HTTP内容协商,建议格式预定义为JSON

1.4K20
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    RESTful 接口

    什么是 RESTful 接口 REST -> Respresentational State Transfer(表述性状态转移) REST 将资源的状态以适合客户端的形式从服务端发送到客户端(或相反方向...RESTful 表示 REST 的形容词。 RESTful 接口是一种设计风格,用于构建网络应用程序的 API。...在 RESTful 接口中,每个资源都由唯一的 URL 标识,比使用 HTTP 方法(如GET、POST、PUT、DELETE)对资源进行操作。...RESTful 接口还使用 HTTP 状态码来表示请求的处理结果,例如 200 表示成功、404 表示资源未找到等。RESTful 接口还支持数据的不同表示格式常用的有 JSON 和 XML。...统一接口(uniform interface):客户端和服务器之间的通信方法必须统一,RESTful 风格的数据元操作 CRUD(Create、Read、Update、Delete) 分别对应 HTTP

    1.3K30

    restful接口规范

    0902自我总结 restful接口规范 1.一般都采用安全协议(接口都是操作数据的):https http协议 应用层协议 请求与响应规范:首行 - 头 - 体 特点:无状态、无连接、请求永远是客户端到服务器端...、ssl 而 https协议 相对于http协议多了个ssl安全套接层 #https比http传输速度要蛮 #https比http数据更加安全 2.体现接口的关键字 https://api.xxx.com.../books/ 3.接口操作的数据称之为资源:采用资源名称的复数 https://api.xxx.com/books/ 4.接口链接中不出现操作资源的动词,通过请求方式来决定操作资源的动作 get|...P)/ get:获取一个 | put:整体修改一个(patch:局部修改一个) | delet:删除一个 5.资源数据有多版本时,接口可以做版本控制 https://api.xxx.com/...)要表明请求二次资源的接口 { 'status': 1, #数据状态码 'msg': 'login failed' #内容 'results':

    1.4K20

    RESTful接口测试

    RESTful风格的接口与测试工程师有什么关系呢?要想真正理解RESTful风格的接口与测试工程师的关系,就必须先弄清楚RESTful风格的接口有什么优点。...但是,RESTful接口测试与前面讲过的HTTP接口测试是有一些区别的,因而我们需要对现有的框架做一些修改,以便更好地支持RESTful接口测试。...现在,您明白了RESTful接口测试和HTTP接口测试有很大的关系,那么RESTful接口测试和HTTP接口测试又有什么区别呢?两个关键点——数据交换的承载方式和操作方式需要特别关注。...下面介绍如何使用JSON库进行序列化和反序列化,我们以在CSDN网站上搜索性能关键字后返回的JSON字符串为例(可以看到头信息中包含“application/json”),如代码清单5-1所示。...其实,为了实现RESTful风格的接口测试,只需要封装HTTP对应的方法就可以了,这样您的框架就能完美地支持RESTful风格的接口了。

    34730

    RESTful接口入门 转

    RESTful产生背景 从下面的图片可以看出,当我们需要把相同的数据展示到不同的界面上时,提供一个可以访问后台的接口,前台只负责将数据友好的,华丽的展示出来即可。...在RESTful架构中,每个网址代表一种资源(resource),所以网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。...一般来说,数据库中的表都是同种记录的”集合”(collection),所以API中的名词也应该使用复数。...limit=10:指定返回记录的数量 ?offset=10:指定返回记录的开始位置。 ?page=2&per_page=100:指定第几页,以及每页的记录数。 ?...使用方法 由于RESTful接口返回的都是json格式的数据,做好对这些json处理即可。

    1K30

    RESTful 接口设计指南

    因此,必须有一种统一的机制,方便不同的前端设备与后端进行通信,这导致 API 构架的流 行,甚至出现"API First"的设计思想,RESTful API 是目前比较成熟的一套互联网应用程序的 API...一个好的 RESTful API 我们应从以下几个方面考虑: 1.协议,建议使用更安全的https协议。 2.域名,尽量部署在专属域名下面。...路径,在RESTful架构中,每个网址代表一种资源(resource),所以网址中建议不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。...一般来说,数据库中的表都是同种记录的"集合"(collection),所以 API 中的名词也应该使用复数。 5. Http 请求数据的方式。 (1).GET(SELECT),查询服务器资源。

    78910

    前后端分离开发,RESTful 接口如何设计

    RESTful 接口设计的干货。...password -d @book.xml -H "Content-type: text/xml" http://fakelibrary.org/book 此时,服务器可能会对提交的内容进行校验,创建与图书相关的记录...这种观点与 RESTful 架构的功能相距甚远。如果不全面深入理解 RESTful 的架构实现,就很容易误解 REST 实践的本意。...尽管客户端不需要知道请求的资源内容,但是请求返回的结果是带元数据标记的字节流,这表明客户端应该知道如何解释资源。...在新增雇员、下订单或提交表单的时候,我们无法预测服务器将如何命名正在创建的资源。这就是为什么将资源提交给类似 Servlet 这样的程序处理。接下来,服务器会接受请求、校验请求、验证用户凭据等。

    3K01

    【RESTful】RESTful API 接口设计规范 | 示例

    安全性:RESTful 对于资源型服务器接口比较适合,适合对于效率要求很高,但是对于安全要求不高的场景。...SOAP 的成熟性可以给需要提供给多开发语言的,对于安全性的要求较高的接口设计带来便利,你可以在客户端和服务端应用证书进行安全措施。所以关键看应用场景。...使用RESTful 设计RESTful API 资源路径(URI):RESTful的核心是面向资源,如何规划资源路径很重要 HTTP动词(请求方式):如get,post,delete,put...zoos : 新建一个动物园 GET/zoos/ID : 获取某个指定动物园的信息 PUT/zoos/ID : 更新某个指定动物园的信息 DELETE/zoos/ID : 删除某个动物园 过滤信息 如果记录数量过多...offset = 10 :指定返回记录的开始位置 ?page = 2&per_page = 100 :指定第几页,以及每页的记录数 ?

    3.1K20

    Restful 接口设计最佳事件

    点击关注⬆️nginx⬆️,学习lnmp 本小编这一年是在一家移动互联网公司做App后端接口设计开发工作,最近组内做了一次很大的重构,就是把接口完全根据restful规范进行设计重写。...这么做的目的首先是减少和前端app同事的交流成本,其次是因为restful真的已经成为最流行的一种接口设计规范,像instagram、facebooke都在使用,下面是instagram提供的在线接口文档截图...下图是我们的接口文档截图: ? 本文只对restful 设计理论进行讲解,如果你真的决定使用它,有什么别的问题可以留言,比如用什么工具去设计api文档,等等。...主题开始登场: 目前互联网上充斥着大量的关于RESTful API(为方便,下文中“RESTful API ”简写为“API”)如何设计的文章,然而却没有一个”万能“的设计标准:如何鉴权?...使用邮件列表或者博客记录是好方法。 版本化 在API上加入版本信息可以有效的防止用户访问已经更新了的API,同时也能让不同主要版本之间平稳过渡。

    1.1K30
    领券