关于RESTful（仅供参考）

1. GET（SELECT）：从服务器取出资源（一项或多项）
2. POST（CREATE）：在服务器新建一个资源
3. PUT（UPDATE）：在服务器更新资源（客户端提供完整资源数据）
4. PATCH（UPDATE）：在服务器更新资源（客户端提供需要修改的资源数据）
5. DELETE（DELETE）：从服务器删除资源

PATCH 方法用来更新局部资源?
PUT 方法用来更新完整的资源
PATCH 与 PUT 属性上的一个重要区别还在于：PUT 是幂等的，而 PATCH 不是幂等的
?
参考?理解HTTP幂等性，RESTful 手册

• 当GET,PUT和PATCH请求成功时，要返回对应的数据，及状态码200，即SUCCESS
• 当POST创建数据成功时，要返回创建的数据，及状态码201，即CREATED
• 当DELETE删除数据成功时，不返回数据，状态码要返回204，即NO CONTENT
• 当GET不到数据时，状态码要返回404，即NOT FOUND
• 任何时候，如果请求有问题，如校验请求数据时发现错误，要返回状态码400，即BAD REQUEST
• 当API 请求需要用户认证时，如果request中的认证信息不正确，要返回状态码401，即NOT AUTHORIZED
• 当API 请求需要验证用户权限时，如果当前用户无相应权限，要返回状态码403，即FORBIDDEN

• Number可以表示整数和浮点数。
• Boolean可以表示真假，值为true或false。
• String表示一个字符串。
• Null通常用于表示空对象。

返回的数据包含在http响应体中。数据?必须(MUST)?是一个JSON Object。该Object可能包含3个字段：状态，状态信息，数据，版本号（如需要的话）。

{

    "code": 200,

    "msg": {

        "text": "参数错误",

        "parameters": {

            "email": "电子邮件格式不正确"

        }

    },

    "data": {

        "data": [

            {

                "name": "Google",

                "url": "http://www.google.com"

            }

        ],

        "dateSelect": [

            "2018-1-1",

            "2018-1-3"

        ],

        "has_next": true,

        "has_prev": false,

        "page": 0,

        "pageSize": 1,

        "keyword": "",

        "totle": 20

    },

    "version": "3.0.2"

}

/api/v1/order/

/api/v2/order/

# Bad APIs

/api/getOrder/1/

/api/updateOrder/1/

/api/deleteOrder/1/



# Good APIs

/api/Order/1/

# Bad APIs



# [DELETE]

/api/Order?id=1

/api/Order&display=15&current=1&type=1