【问题标题】:Appropriate REST method/path/response for server operation服务器操作的适当 REST 方法/路径/响应
【发布时间】:2017-03-26 15:29:59
【问题描述】:

我正在寻找在以下场景中使用的最佳 REST 方法/路径: 有一个系统有 usersprojects,其中每个项目有几个 tasks(task 只能与单个项目关联),每个用户可以分配给任何任务。

我愿意添加的 API 是自动将用户分配给特定项目上的任务的 API,所以基本上用户要求服务器分配他一些任务。

我认为以下网址:

  • PATCH /project/{id}/tasks - 即用户要求服务器以服务器认为最好的方式更新任务列表
  • PATCH /project/{id}/tasks/assign - 有url的具体操作部分

我选择PATCH 的原因是因为任务只是部分更改(每个任务都有一个user 字段,这基本上是我想要更新的内容)。

我面临的另一个问题是,如果项目中没有更多“打开”任务,响应代码应该是什么?向用户表明他没有获得任何新任务的最佳方式是什么?

谢谢!

【问题讨论】:

    标签: rest api restful-architecture restful-url


    【解决方案1】:

    分配任务给用户是新的assignment 资源,其中包含projectIduserIdtaskId(在服务器端自动选择)。以这种方式处理它只允许应用 GETPOSTDELETE HTTP 方法来管理特定分配。

    资源 URL 可能(取决于您的方案)如下:

    GET:  project/{id}/assignments/{userId}
    POST: project/{id}/assignments/{userId}
    

    如果找到任务并创建了作业,则应return 201 发布新作业,否则应200

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2015-07-27
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多