码迷,mamicode.com
首页 > 其他好文 > 详细

Django中的RESTful

时间:2018-06-19 11:45:21      阅读:133      评论:0      收藏:0      [点我收藏+]

标签:错误   delete   django   target   使用   sel   状态码   很多   完整   

一:谈谈你对restful规范的理解:

  -restful其实就是一种编写接口的设计风格,如果一个架构满足rest的三个原则,那么他就是restful架构,

  1. 每一个URL代表一种资源

  2.通过在请求头中用Accept和Content-type字段指定其表现形式,客户端和服务器之间传递这种表现层。

  3.客户端通过HTTP四个动词,对服务器资源进行操作,实现‘表现层的状态转换’,GET用于获取资源,POST用于新建资源,PUT用于更新资源,DElETE用于删除资源。

二;

        2. 你的restful是怎么学的?
            - 因为之前公司要写这样项目
                - 接口
                - 公司要做前后端分离的项目
                - 公司要做微信小程序的开发

三:设计 方法:

  1.域名:应该尽量将API部署在专用域名之下:

  2.版本:应该将API的版本号放入URL

  3.路径Endpoint:每个网址代表一种资源,只能有名词,不能有动词,名词应该使用复数

  4.对于资源的具体操作类型,由HTTP动词表示。

    GET(SELECT):从服务器取出资源(一项或多项)。

    POST(CREATE):在服务器新建一个资源。

    PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。

    DELETE(DELETE):从服务器删除资源。

  5.过滤信息:如果记录数量很多,服务器不可能都将它们返回给用户。API应该提供参数,过滤返回结果。

  6.状态码:

  7.错误处理:

  8.返回结果。

针对不同操作,服务器向用户返回的结果应该符合以下规范。

  • GET /collection:返回资源对象的列表(数组)
  • GET /collection/resource:返回单个资源对象
  • POST /collection:返回新生成的资源对象
  • PUT /collection/resource:返回完整的资源对象
  • PATCH /collection/resource:返回完整的资源对象
  • DELETE /collection/resource:返回一个空文档。

  9.超媒体:

  RESTful API最好做到Hypermedia(即返回结果中提供链接,连向其他API方法),使得用户不查文档,也知道下一步应该做什么。

  比如,Github的API就是这种设计,访问api.github.com会得到一个所有可用API的网址列表

Django中的RESTful

标签:错误   delete   django   target   使用   sel   状态码   很多   完整   

原文地址:https://www.cnblogs.com/zxt-cn/p/9197548.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!