RESTFUL规范建议

RESTful概述
RESTful是目前最流行的一种互联网软件架构，是程序和程序之间进行数据交互须要遵循的规范。它结构清晰、符合标准、易于理解、扩展方便，因此正获得愈来愈多网站的采用。

REST是Representational State Transfer的缩写，是Roy Thomas Fielding在他2000年的博士论文中提出的。其提出的设计概念和准则为：

1. 网络上的全部事物均可以抽象为资源

2. 每一个资源都应该有惟一的标识（identifier），对资源的操做不会改变标识

3. 全部的操做都是无状态的

4. 使用标准方法（GET、POST、PUT、PATCH、DELETE）操做资源

规范建议

1. https代替http,保证数据传输时安全。
    2. 在url中通常要体现api标识，这样看到url就知道他是一个api。
        http://www.baidu.com/api/....（建议，由于他不会存在跨域的问题）
        http://api.baidu.com/....
        假设：
            前段：https://www.baidu.com/home
            后端：https://www.baidu.com/api/
    3. 在接口中要体现版本
        http://www.baidu.com/api/v1....
        注意：版本还能够放在请求头中
            http://www.baidu.com/api/
            accept: ...
            
    4. restful也称为面向资源编程，视网络上的一切都是资源，对资源能够进行操做，因此通常资源都用名词。
        http://www.baidu.com/api/user/
        
    5. 若是要加入一些筛选条件，能够添加在url中    
        http://www.baidu.com/api/user/?page=1&type=9

    6. 根据method不一样作不一样操做。
            get、post、put、patch、delete
    7. 返回给用户状态码
        - 200，成功
        - 300，301永久 /302临时
        - 400，403拒绝 /404找不到
        - 500，服务端代码错误
        
        自定制状态码：
                def get(self,request,*args,**kwargs):
                    result = {'code':1000,'data':None,'error':None}
                    try:
                        val = int('你好')
                    except Exception as e:
                        result['code'] = 10001
                        result['error'] = '数据转换错误'
                    return Response(result)
        
    8. 返回值
        GET http://www.baidu.com/api/user/
            [
                {'id':1,'name':'rsx','age':19},
                {'id':1,'name':'rsx','age':19},
            ]
        POST http://www.baidu.com/api/user/
            {'id':1,'name':'rsx','age':43}
            
        GET http://www.baidu.com/api/user/2/
            {'id':2,'name':'rsx','age':43}
            
        PUT http://www.baidu.com/api/user/2/
            {'id':2,'name':'rsx','age':43}
        
        PATCH https//www.baidu.com/api/user/2/
            {'id':2,'name':'rsx','age':43}
            
        DELETE https//www.baidu.com/api/user/2/
            空
    9. 操做异常时，要返回错误信息
    
        {
            error: "Invalid API key"
        }
    10. 对于下一个请求要返回一些接口：Hypermedia AP
        {
            'id':2,
            'name':'rsx',
            'age':43,
            'depart': "http://www.baidu.com/api/user/30/"
        }