rest api设计的一般原则

本文参考自：http://www.ruanyifeng.com/blog/2014/05/restful_api.html

服务器端：

1. JSON形式：

无论成功还是失败，最好附有一个link字段，用于标注相关的api，提示用户下一步可以做什么，如下：

{

"link": {
  "rel":   "collection https://www.example.com/zoos",//这个API与当前网址的关系
  "href":  "https://api.example.com/zoos",//api地址
  "title": "List of zoos",//api标题
  "type":  "application/vnd.yourformat+json"//api返回值类型
}

}

补充：

API与用户的通信协议，总是使用HTTPs协议。

API的身份认证应该使用OAuth 2.0框架。