任务队列的休息设计

Question

我正在设计一个任务队列休息界面并想知道最佳实践。

一个动作是接受队列中的“下一个”任务。

通过接受工作，只有第一个工人才能得到这份工作。

在接受工作之前，工作人员不会知道任务或任务 ID。

现在我想我不能使用 GET 因为它不是幂等的。如果调用 nextTask 两次，你会得到两个不同的工作。所以我想它应该是一个POST。

POST //rest/taskqueue?action=acceptTask

还是我看错了？

Answer 1

基本上：

• GET - 读取数据而不修改资源（幂等）。您可以根据需要执行任意数量的 GET，它永远不会修改资源。
• PUT - 将数据显式放入资源中（非幂等）
• POST - 在资源中追加数据（非幂等）
• DELETE - 从资源中删除数据（非幂等）

这就是我要做的。

加入一个新任务：

--> POST http://api.crazyjoes.com/v1/tasks/
--> {"data":{"lulcat":true}}
<-- 202 Accepted

将具有特定 ID 的新任务加入队列：

--> PUT http://api.crazyjoes.com/v1/tasks/393ee7f6-c44a-4b34-86ac-92c9f31a4bc6/
--> {"data":{"lulcat":true}}
<-- 202 Accepted

检索最旧的任务：

--> GET http://api.crazyjoes.com/v1/tasks/oldest/
<-- 200 OK
<-- {"id":123,"data":{"lulcat":true}}

如果队列为空：

--> GET http://api.crazyjoes.com/v1/tasks/oldest/
<-- 204 No Content

出列特定任务：

--> DELETE http://api.crazyjoes.com/v1/tasks/123/
<-- 200 OK
<-- {"id":123,"data":{"lulcat":true}}

如果任务已经被处理...

--> DELETE http://api.crazyjoes.com/v1/tasks/123/
<-- 410 Gone

如果要直接出列最旧的项目...

--> DELETE http://api.crazyjoes.com/v1/tasks/oldest/
<-- 200 OK
<-- {"id":123,"data":{"lulcat":true}}