超级会员免费看
本文总结了RESTful API设计规范，包括协议、域名、版本管理、路径、HTTP动词、过滤信息、状态码、错误处理、返回结果以及超媒体API。遵循这些规范能帮助创建清晰、一致且易于使用的API。
一个好的API设计，是应该遵循资源导向的，需要见名知义。
一、协议
API与用户的通信协议，总是使用HTTPs协议。
二、域名
应该尽量将API部署在专用域名之下。
https://api.example.com
如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。
https://example.org/api/
三、版本（Versioning）
应该将API的版本号放入URL。
https://api.example.com/v1/
另一种做法是，将版本号放在HTTP头信息中，但不如放入URL方便和直观。
订阅专栏 解锁全文
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
