REST API设计规范

 

 

 

1. 彻底面向资源，API以复数形式表示

2. 路径（Endpoint）

   • http://example.com/libraries //列出全部图书馆

   • http://example.com/books //列出全部图书

   • http://example.com/libraries/ID/books //列出某个图书馆的所有图书

   • http://example.com/libraries/ID/books/ID //列出某个图书馆的某本图书

3. 筛选条件
   

   • http://example.com/books?library_id=ID //参数的存在容许API路径与URL参数有相同的含义

   • http://example.com/libraries/ID/books?book_type=biography&year=2010 //筛选出2010年出版的传记类图书

4. HTTP动词

• GET 从服务器取出资源

• POST 向服务器新建资源

• PUT 向服务器更新资源（客户端向服务器提供完整的资源）

• PATCH 向服务器更新资源（客户端向服务器提供更新的属性）

• DELETE 删除资源

5. 状态码——经常使用的HTTP状态码

• 200 服务器成功返回网页

• 304 未修改

• 404 请求的网页未存在

• 503 服务器暂时不可用

• 504 网关超时

• 500 服务器内部错误

6. 错误处理：若是返回状态码是4xx，就应该向客户端返回错误信息，一般将error做为键名，错误信息做为键值便可。

   • { error: "Invalid API key" }