1、api 路径设计  

      路径名   http://{域名}/{微服务简称}/api{模块}/

      为了和域名命名规则保持一致,使用小写字母并用-分割路径名字

  1. 不使用rest的PUT和DELETE,因为很多浏览器不支持,很多框架也不支持
  2. POST在需要传输大量数据的时候使用,其余使用GET就可以了;
  3. 所有路径path全部小写,以下划线分隔,所有参数,包括POST里面的body,以及header。
  4. 我们返回一般统一使用json格式返回
  5. 在url上必须包含行为
  6. 使用Token令牌来做用户身份的校验与权限分级,而不是Cookie
  7. 暴露外部请求一定使用SSL

2. HTTP请求规范

   GET (SELECT): 查询;从服务器取出资源.
   POST(CREATE): 新增; 在服务器上新建一个资源。
   PUT(UPDATE): 更新; 在服务器上更新资源(客户端提供改变后的完整资源)。
   PATCH(UPDATE): 更新;在服务器上更新部分资源(客户端提供改变的属性)。
   DELETE(DELETE): 删除; 从服务器上删除资源。