图片检测接口如何设计 REST API

Question

基本功能就是上传图片，然后返回图片类别。

这样的接口应该如何设计成REST API呢，如何进行资源抽象？

Answer 1

没有办法设计为 restful 接口

原因很简单：

• restful 规范，查询要用 GET
• 但是 GET 不能有 request body，（技术上可以，感情上不行）
• 上传图片需要把图片放到 request body 中

---

有两种方案可以参考一下：

方案一：分离大法

• 使用 POST /api/file/ 上传文件，返回 file_id
• 使用 GET /api/file/{file_id} 查询，获取查询结果

方案二：妥协法

• 使用 POST /api/file/ 上传文件，返回查询结果

推荐后者，就是方案二，因为简单，分两次麻烦