box-api - Box API 2.0 设置 shared_link 返回 404

Question

最近我一直在玩 Box.com 的 API 2.0 版。

根据官方说明
this document ，我可以成功地将文件的“访问”设置为“打开”。

但是，如果我将其更改为“公司”或“合作者”，服务器将返回一个响应，指出未找到 HTTP 404，如下所示。

{
   "type":"error",
   "status":404,
   "code":"not_found",
   "help_url":"http:\/\/developers.box.com\/docs\/#errors",
   "message":"Not Found",
   "request_id":"609097837503b1dabc4d0c"
}

而且我无法弄清楚此消息“未找到”究竟是什么意思。

这是我发送的请求正文，没问题

{
   "shared_link":{
      "access":"Open",
      "permissions":{
         "download":true,
         "preview":true
      }
   }
}

这是返回错误的请求正文

{
   "shared_link":{
      "access":"company",
      "permissions":{
         "download":true,
         "preview":true
      }
   }
}

我想知道它是我不应该做的事情还是只是 api 中的一个错误。

提前感谢您的任何回复。

================================

问题的一些更新。

恐怕不是案件相关的问题
尽管我看到文档上的示例确实使用了大写的“Open”。

在我的情况下，使用“打开”或“打开”，
我可以毫无问题地成功设置共享链接。

但是，以下案例的行为对我来说有点奇怪。

情况 1:将权限中的两个属性(下载和预览)设置为 false 返回 404
(仅将其中一个设置为 true 可以正常工作)

{
   "shared_link":{
      "access":"Open",
      "permissions":{
         "download":false,
         "preview":false
      }
   }
}

在以下情况下，为了说明目的，我首先将“访问”设置为“打开”。

案例 2:将“访问”设置为“合作者”返回 404 未找到

案例 3:将“访问”设置为“合作者”
工作正常，但 json 响应没有正确地将“访问”显示为“合作者”

以下是案例3的回应摘录，“访问”仍然是“打开”

    shared_link": {
    "url": "https://www.box.com/s/03a47eb4b7dce0439d7f",
    "download_url": "https://www.box.com/shared/static/03a47eb4b7dce0439d7f.pdf",
    "password_enabled": false,
    "unshared_at": null,
    "download_count": 0,
    "preview_count": 0,
    "access": "Open",
    "permissions": {
        "download": true,
        "preview": true
    }

“公司”似乎与以前的案例相同，所以我就到此为止。

出于好奇，我将“访问”设置为文档中提到的字符以外的任意字符(我尝试过诸如“pp”、“c”、“test”之类的词)，
有趣的是，服务器似乎都返回 200:OK 但 json 响应仍然是“访问”:“打开”。比较困惑。

Answer 1

原来“访问”参数是区分大小写的。我们现在已经解决了这个问题，所以“打开”和“打开”等都可以工作。

事实证明，您还在文件共享方面暴露了一些棘手的边缘情况。您可以设置一些安全设置，例如“文件夹属性:安全”设置，其中显示“仅限协作者共享链接”。



事实证明，如果您设置了此设置，该 API 调用将“访问”设置为“打开”，我们将返回 404。我们将努力使其成为一个更具信息性的错误(如 403，拒绝访问)。

至于其余的情况。

案例1:我们的 web-ui 限制您设置其中一些组合(例如 download=false 和 preview=false)，因为当我们构建共享功能时，我们认为拥有不可下载、不可预览的文件是没有意义的.

案例 2(和案例 3 的一部分):设置为“合作者”或“合作者”现在应该可以正常工作。错误已修复。

案例3:设置为“co”或“foo”默认为“Open”。我们现在已将其更改为返回错误(再次 404)。

希望有帮助。