如何编写REST API

编写REST API

REST API规范
编写REST API，实际上就是编写处理HTTP请求的async函数，不过，REST请求和普通的HTTP请求有几个特殊的地方：

REST请求仍然是标准的HTTP请求，但是，除了GET请求外，POST、PUT等请求的body是JSON数据格式，请求的Content-Type为application/json；
REST响应返回的结果是JSON数据格式，因此，响应的Content-Type也是application/json。
REST规范定义了资源的通用访问格式，虽然它不是一个强制要求，但遵守该规范可以让人易于理解。

例如，商品Product就是一种资源。获取所有Product的URL如下：

GET /api/products
而获取某个指定的Product，例如，id为123的Product，其URL如下：

GET /api/products/123
新建一个Product使用POST请求，JSON数据包含在body中，URL如下：

POST /api/products
更新一个Product使用PUT请求，例如，更新id为123的Product，其URL如下：

PUT /api/products/123
删除一个Product使用DELETE请求，例如，删除id为123的Product，其URL如下：

DELETE /api/products/123
资源还可以按层次组织。例如，获取某个Product的所有评论，使用：

GET