如何规范的写api

一、协议
API 与客户端通讯协议主要包含 http 和 https，建议使用 https 确保交互数据的传输安全。

二、域名
应该尽量将API部署在专用域名之下。
https://api.example.com
如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。
https://example.org/api/

三、api版本控制
应该将API的版本号放入URL。
https://api.example.com/v{n}/
另一种做法是，将版本号放在HTTP头信息中，但不如放入URL方便和直观。Github采用这种做法。
采用多版本并存，增量发布的方式。
v{n}： n代表版本号,分为整形和浮点型
整型版本号：大功能版本发布形式；具有当前版本状态下的所有API接口 。例如：v1、v2
浮点型版本号：为小版本号，只具备补充api的功能，其他api都默认调用对应大版本号的api。例如：v1.1、 v2.2

四、API路径规则
路径又称"终点"（endpoint），表示API的具体网址。
在RESTful架构中，每个网址代表一种资源（resource），所以网址中不能有动词，只能有名词，而且所用的名词往往与数据库的表格名对应。一般来说，数据库中的表都是同种记录的"集合"（collection），所以API中的名词也应该使用复数。
举例来说，有一个API提供动物园（z