RESTful 设计指南
为了方便不同的前端设备与后端进行通信,必须有一种统一的机制,导致API构架流行
一、协议
API与用户的通信协议,总是使用Https协议。
二、域名
应该尽量将API部署在专用的域名下。
https://api.example.com |
---|
如果确定API很简单,不会有进一步扩展,可以考虑放在主域名下。
https://example.org/api |
---|
三、版本(Versioning)
应该将API的版本号放入URL。
https://api.example.com/v1/ |
---|
另一种做法是,将版本号放在HTTP头信息中,但不如放入URL方便和直观。 Github采用这种方法。
网友评论