restful-如何设计RESTful的视图层API?

问题描述

如何设计RESTful的视图层API?

很多关于RESTful的文章都详细介绍了设计几个基础API的URL, 例:
GET /users
GET /users/{name}
POST /users/{name}
PUT /users/{name}
DELETE /users/{name}

这里的两个GET, 我的理解应该是返回json的数据.
对应这套增删改查, 通常会有这样三个页面:
user/list.html
user/add.html
user/edit.html

那么请求这些html文本URL, 应该如何按照RESTful去设计呢?


有人说html是客户端的东西, restful只管服务器, 但是rest概念中的资源和超媒体, 难道只有json和xml, 不包括html和视图层吗?


补充: 看了下关于html是静态文件的回答, 那么我换个简单问法,
当我想请求一个网站的用户列表页面, 我在浏览器里输入的url,
应该是 /user/list.html
还是 /users/ ?

如果按照"静态文件"的说法, 用html + ajax来获取数据, 那么url就应该是前者, 然而我观察到的现在restful的网站明显不是这么干的. 比如github, Amazon, 他们在浏览器里的url就是 /products/{productid} 这样.

解决方案

返回json也好,xml也好,html也好,都是字符串,都可以做到。但是一般rest风格用于json或者xml等格式的接口,调用服务端接口是在一个页面中进行操作时触发的,页面本身没必要用接口的方式获取。
就是说:打开或者跳转页面不需要什么rest风格,在页面进行数据提交时,与服务器端交互,可以用rest风格接口。

解决方案二:

Restful API的设计
RESTful API 设计

解决方案三:

html不也是string,返回html有什么用?

解决方案四:

reatful是API。它处理的是各种动态资源。它不是返回你html的。对于html它是静态资源。不需要restful API。一般是服务器直接返回就可以了

时间: 2024-08-29 10:29:18

restful-如何设计RESTful的视图层API?的相关文章

restful 架构设计 原理 运用

问题描述 restful 架构设计 原理 运用 在网络应用中有restful架构已经很热很久了,但是我现在还不是很清楚到底什么是restful思想,原理,然后需要在项目中怎样去运用,希望大家能给我相关资料学习参考下,谢谢 解决方案 http://lwe.iteye.com/blog/1484781

如何更好的设计RESTful API

当您的数据模型已开始稳定,您可以为您的网络应用程序创建公共API. 你意识到,很难对你的API进行重大更改,一旦它发布,并希望尽可能得到尽可能多的前面. 现在,互联网对API设计的意见有很多. 但是,因为没有一个广泛采用的标准在所有情况下都有效,所以你前面有一堆选择:你应该接受什么格式? 你应该如何认证? 你的API是否应该版本化?构建API是您可以做的最重要的事情之一,以提高您的服务的价值. 通过使用API,您的服务/核心应用程序有可能成为其他服务增长的平台. 看看当前巨大的科技公司:Face

通用查询引擎Restful service设计(目前支持hive,shark)

最近在设计开发一个通用查询Restful Service (https://github.com/lalaguozhe/polestar-1) ,项目名polestar (中文名叫北极星,野营灯,指导者,希望把大家的查询语句都吸引汇聚过来,你懂的) ,之前查询Hive语句基本都是走Hive Server,但是Hive Server 1不太完善,比如 1. 有编译器memory leak问题 2. thrift api不支持multiple connections和client sessions

如何设计一套事件日志API

简介 业界目前已经在以下这一点上达成了强烈的共识:API的设计应该是按照前端到后端的次序进行的,将重点放在开发者对API的使用上.在某个发展兴旺的商业体中,通常会存在着许多互相竞争的产品与API的实现,而易于使用.并且设计良好的API在吸引与保留开发者这一点更有优势.此外,新的工具不断涌现,它们不仅能够帮助开发者按照迭代方式设计API,而且能够帮助开发者学习与使用这些API. API设计中的关键因素在于"人",这意味着API设计工具与文档格式必须便于人的读写,这一段时期以来的API设计

Web API核查表:设计、测试、发布API时需思考的43件事

当设计.测试或发布一个新的Web API时,你是在一个原有的复杂系统上构建新的系统.那么至少,你也要建立在HTTP上,而HTTP则是基于TCP/IP创建的.TCP/IP建立在一系列的管道上.当然,你也需要考虑Web服务器.应用程序框架或者是API框架. API从设计到测试以至最终的发布需要经历一个漫长的过程,本文将主要探讨Web API从设计到最终发布,开发者可能忽略或者应该注意的东西. HTTP篇 HTTP 1.1规范RFC2616是一个非常大的文档,下面我们节选了一些可能会对API产生影响的

在WebSphere Cast Iron中使用JSON(三) 设计基于JSON的REST API

简介 WebSphere Cast Iron(后面简称为 Cast Iron)被广泛用于遍及内部和外部应用程序的集成和迁移.过去,JSON  被普遍用作 REST API 的传输类型,因为与 XML 相比,它的格式是轻量级的. 在 Cast Iron 中,您可以创建和公开一个基于 JSON 的 API,这是一个以 JSON 格式接受请求并发送响应的整合流程.Cast Iron 使用了 XML 和XML 模式.Cast Iron 引入了两个用来处理 JSON 数据的新活动:Read JSON 和

应用开发流程设计之验证码短信API接口

中介交易 http://www.aliyun.com/zixun/aggregation/6858.html">SEO诊断 淘宝客 云主机 技术大厅 在互联网信息泛滥的今天,大量的不真实手机号码.无效的信息铺满网站,给企业对网站用户回访等带来诸多不遍,如何获取真实可靠的客户信息,显得尤为重要. 为了让网站自动验证客户联系手机号码的真实性,启科网络与中国移动. 联通.电信三大通信运行商合作,研发了一套大型的短信发送应用平台,通过短信接口网关发送手机验证码,即解决了手机号码的认证问题,可以用来

html-ASP中HTML控件,UI层获取文本值问题

问题描述 ASP中HTML控件,UI层获取文本值问题 asp:code 姓名 年龄 住址 备注 Cs:code public partial class AddUserInfo : System.Web.UI.Page { UserInfoManager userinfoManager = new UserInfoManager(); protected string userName; protected int age; protected string address; protected

我所理解的RESTful Web API [设计篇]

<我所理解的RESTful Web API [Web标准篇]>Web服务已经成为了异质系统之间的互联与集成的主要手段,在过去一段不短的时间里,Web服务几乎清一水地采用SOAP来构建.构建REST风格的Web服务是最近两三年风行的潮流,所以很多人以为REST是一个事物.而事实却是:REST自其诞生之日起到现在(2014年)已经有14年了,它为什么叫这么一个"奇怪"的名字呢? 目录 一.为什么叫这个"奇怪"的名字?二.采用URI标识资源 二.采用URI标识