1. 遵守RESTful API 规范

RESTful API

• 域名
  应该尽量将API部署在专用域名之下

  https://api.example.com
  

  如果确定API很简单，不会有进一步的扩展，可以考虑放在主域名下

  https://example.com/api/
  

• 协议
  推荐用 HTTPS

• 版本
  应该将API的版本号放入URL

  https://api.example.com/v1.0/apples/
  https://api.example.com/v1.1/apples/
  https://api.example.com/v2.0/apples/
  

• 路径
  推荐用名词+复数
  对于一个简洁结构,你应该始终用名词。此外,利用的HTTP方法可以分离网址中的资源名称的操作。

  GET      /products    :将返回所有的产品清单
  POST     /products    :将产品新建到集合
  GET      /products/4  :将获取产品4
  PATCH    /products/4  :将更新产品4 （部分属性更新）
  PUT      /products/4  :将更新产品4 （全部属性更新）
  DELETE   /products/4  :将删除产品4
  

• HTTP动词

  请求方法	请求地址	后端操作
  GET	/students	获取所有学生

标签：API,com,api,products,遵守,https,RESTful,example
来源： https://www.cnblogs.com/liuyz7975/p/16241424.html