api设计规范

前言

说到restful，其实我们并不完全遵循restful规范。我们会参考restful的设计理念，并且结合我们自己的一些实践来对web api进行设计。

我们一起来看看RESTFul API有哪些特点：

1. 基于“资源”，数据也好、服务也好，在RESTFul设计里一切都是资源。GET：查询，POST：新增，PUT：更新，DELETE：删除
2. 无状态。一次调用一般就会返回结果，不存在类似于“打开连接-访问数据-关闭连接”这种依赖于上一次调用的情况。
3. URL中通常不出现动词，只有名词
4. URL语义清晰、明确，使用HTTP的GET、POST、DELETE、PUT来表示对于资源的增删改查
5. 返回结果使用JSON不使用

网站：/get_user?id=100
RESTFul: GET /user/100 (GET是HTTP类型)

*我们通常的GET和POST