原创力文档- 1、原创力文档（book118）网站文档一经付费（服务费），不意味着购买了该文档的版权，仅供个人/单位学习、研究之用，不得用于商业用途，未经授权，严禁复制、发行、汇编、翻译或者网络传播等，侵权必究。。
- 2、本站所有内容均由合作方或网友上传，本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺！文档内容仅供研究参考，付费前请自行鉴别。如您付费，意味着您自己接受本站规则且自行承担风险，本站不退款、不进行额外附加服务；查看《如何避免下载的几个坑》。如果您已付费下载过本站文档，您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等，请点击“版权申诉”（推荐），也可以打举报电话：400-050-0827(电话支持时间：9:00-18:30)。
- 4、该文档为VIP文档，如果想要下载，成为VIP会员后，下载免费。
- 5、成为VIP后，下载本文档将扣除1次下载权益。下载后，不支持退款、换文档。如有疑问请联系我们。
- 6、成为VIP后，您将拥有八大权益，权益包括：VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 7、VIP文档为合作方或网友上传，每下载1次， 网站将根据用户上传文档的质量评分、类型等，对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
第3章Django框架
第11节RESTful接口介绍
www.zhonghui.vip
【学习目标】
Ø理解RESTful架构；
Ø掌握RESTful接口设计规范；
www.zhonghui.vip2
目录
CONTENTS
u1REST架构的理解
u2RESTful接口设计规范
www.zhonghui.vip
1REST架构的理解
Roy·Thomas·Fieding博士将互联网软件的架构原则定名为REST(RepresentationalState
Transfer)。可翻译为“表现层状态转化”。
1.资源（Resource）
在REST中省略了主语，“表现层”指的是“资源”的“表现层”。“资源”是网络的一个
实体或者网络上的具体信息，可以是一张图片、歌曲、服务等。我们可以用一个URI（统一资
源定位符）指向它。“上网”就是与这一系列资源的互动。
2.表现层（Representation）
“资源”是一种信息实体，表现形式不同。我们把资源表现出来的形式称为“表现层”，
比如：文本用txt格式表现也可以用HTML、XML、JSON等其他格式，图片可以用JPG、PNG
等格式表现；但是URI只代表资源的实体，不代表它的形式。我们在HTTP请求的头信息中用
Accept和Content-Type字段指定这两个字段是对“表现层”的描述。
www.zhonghui.vip4
1REST架构的理解
3.状态转化（StateTransfer）
在网站访问过程中，势必存在数据和状态的变化，然而在互联网通信中HTTP是一个无状态
协议。在客户端与服务端发生操作时，需要通过“状态转化”让服务端发生变化，这种方式是
通过HTTP的方法来实现的，包括GET(获取资源)、POST(新建资源)、PUT(更新资源)和
DELTE(删除资源)等。
总结以上内容，在RESTful架构中，每个URI代表一种资源，资源的传递通过表现层实现，
客户端通过HTTP的方法实现状态的转化。
www.zhonghui.vip5
目录
CONTENTS
u1REST架构的理解
u2RESTful接口设计规范
www.zhonghui.vip
2.1基本规范
首先API(ApplicationProgramingInterface,应用程序接口)在设计时需要遵从与使用
HTTP，其次，API应该尽量部署在域名之下，若确定API比较简单，不会进一步扩展，考虑放
在主域名之下。
/
在API设计时需要加入版本号信息，具体规范如下。
/v1/
www.zhonghui.vip7
2.1基本规范
在AP编写时，需要加入路径规范，也就是需要有API网址的具体规范。在RESTful架构中，
每个网址代表一种资源，在访问资源时只能有名字不能有动词，并且名词往往与数据库的表名
对应，比如我们有一个API提供学校(school)的信息，还包括年级(grade)和班级(class)的信息，
那么API的设计规则如下。
/v1/school
/v1/grade
/v1/class
www.zhonghui.vi
文档评论（0）