RESTful Api设计风格
协议:API 与用户的通信协议,总是使用 HTTPS 协议
域名:应该尽量将 API 部署在专用域名之下,如果确定 API 很简单,不会有进一步的扩展,可以考虑放在主域名之下。
版本:
应该将 API 的版本放在 URL 中:https://www.shanghui.xiaxia/api/v1.0
将版本号放在 HTTP 头信息中:https://www.shanghui.xiaxia/user
路径:表示 API 的具体网址,每个网址代表一种资源,所以网址中不能有动词,只能有名词,并且所用的名词往往与数据库的表名对应。数据库中的表示记录同种数据的集合,所以 API 中的名词也应该使用复数。