REST规范

一、什么是RESTful

1、REST与技术无关，代表的是一种软件架构风格，REST是Representaion State Transfer的简称，中文翻译为‘表征状态转移’
2、REST从资源的角度审视整个网络，他将分布在网络中的某个节点的资源通过URL进行标识，客户端应用通过URL来获取资源的表征，获得这些表征致使这些应用转变状态
3、所有的数据，无论是通过网络获取的还是操作(增删改查)的数据，都是资源，将一切数据视为资源是REST区别于其他架构风格的最基本属性
4、对于REST这种面向资源的架构风格，有人提出一种全新的结构理念，即：面向资源架构（ROA：Resource Oriented Architecture）

二、RESTful API设计规范

1. API与用户的通信协议，总是使用HTTPs协议
2. 域名路径总带api
3. 路径，视网络上任何东西都是资源，均使用名词表示（可复数）
4. 通过请求方式区分执行的操作(method有五种：get，post，put，patch，delete)
5. 带有版本号
6. 过滤，通过在url上传参的形式传递搜索条件
7. 返回状态码
8. 返回错误信息
9. 返回结果
   10.Hypermedia API，返回结果中提供链接，连向其他API方法，使用户不查文档，也知道下一步应该做什么
   状态码大全http://tool.oschina.net/commons?type=5

三、基于Django编写restful接口

URL路由系统：

urlpatterns = [
    url(r'^users/$', views.Users.as_view()),
    url(r'^users2/$', views.user2),

]

views视图函数：

import json
# 基于fbv
def  user2(request):
    if request.method=='GET':
        dic = {'status':200,'name': 'lqz2', 'age': 18}
        return HttpResponse(json.dumps(dic))
    elif request.method=='POST':
        dic = {'status': 200, 'msg': '修改成功'}
        return JsonResponse(dic)
# 基于cbv
class Users(View):
    def get(self, request):
        dic = {'status':200,'name': 'lqz', 'age': 18}
        return HttpResponse(json.dumps(dic))

    def post(self, request):
        dic = {'status': 200, 'msg': '修改成功'}
        return JsonResponse(dic)

参考博客：https://www.cnblogs.com/liuqingzheng/articles/9762022.html