使用 Excel 工作表插入批量数据的 RESTful API 端点或 URL 签名应该是什么

Question

情况1：我需要使用excel(xls)插入批量用户。

我实现的内容：

URL: [POST] {{base_url}}/users/bulk
Content: Form Data-MultiPart

Request Body:
fileName: users_20Jan
file: /home/desktop/users.xls

Response Code: 201

该API执行的操作：

1. 将导入users.xls文件保存到云端并输入数据库。
2. 阅读 Excel 工作表的每一行。检查是否存在具有相同凭据的用户。
3. 将数据设置为对象并保存到数据库。

---

情况2：我需要使用excel(xls)插入批量用户，但excel文件已经存在于云端。

我实现的内容：

URL: [POST] {{base_url}}/users/bulk/{{import_file_id}}

Request Body: Empty

Response Code: 201

此 API 执行的操作：

1. 使用 importFileId 从数据库获取文件的下载 URL。
2. 从云端下载文件。
3. 阅读 Excel 工作表的每一行。检查是否存在具有相同凭据的用户。
4. 将数据设置为对象并保存到数据库。

---

是否为这些类型的 RestAPI 定义了任何标准化？如果没有那么有更好的方法吗？

---

仅供参考

 URL: `{{base_url}}/users` is already being used for single-user and an array of users in the JSON request body.

 These all are requirements of the project.

Answer 1

只需添加 requestparam 类型即可将 url 合并为一个。

示例：

  {{base_url}}/users/files/{{filename}}?type=file
  {{base_url}}/users/files/{{import_file_id}}?type=fileId

这样我们就可以重复使用相同的方法来进行类似的操作