Restful API 具体设计规范（概述）

1. 协议

   https

2. 域名

   https://www.baidu.com/api

3. 版本

   https://www.baidu.com/v1

4. 路径

   https://www.baidu.com/v1/blogs

5. 方法

6. 数据过滤

7. 状态码
8. 返回结果

9. 返回的数据格式

   尽量使用 JSON，避免使用 XML。

总结：

1. 看 url 就知道要什么
2. 看 http method 就知道干什么
3. 看 http status 就知道结果如何