仅通过框 API 将共享链接限制为协作者

Question

我正在尝试为企业中的用户设置一个预配置的文件夹，其中共享选项仅限于协作者。

此功能在安全选项卡下的文件夹属性表单中的 Web 界面中可用："Restrict shared links to collaborators only"

框内容 API (v2) 允许创建和修改共享 links，这按预期工作；但不清楚 whether/how 我们可以限制共享 link 选项。

文件夹更新的 API 文档：developers.box.com/docs/#folders-update-information-about-a-folder 似乎表明有一个访问属性文件夹除了 shared_link 属性：

access：可以是公开的也可以是合作者。类型：对象

如果不是 "collaborators" 字符串，我不确定对象值是什么。

我试过：

curl https://api.box.com/2.0/folders/FOLDER_ID \
-H "Authorization: Bearer ACCESS_TOKEN"  \
-H "As-User: USER_ID" \
-d '{"access": "collaborators"}' -X PUT

和

curl https://api.box.com/2.0/folders/FOLDER_ID \
-H "Authorization: Bearer ACCESS_TOKEN"  \
-H "As-User: USER_ID" \
-d '{"access": {"access": "collaborators"}}' -X PUT

两个 return 状态都是 200，尽管它们似乎没有做任何事情。

Answer 1

access 字段实际上是 shared_link 字段的子字段，这就是为什么它在文档中略微缩进的原因（这有点难以看清）。如果您想创建文件夹的共享 link 并限制协作者的访问权限，您可以通过以下请求来实现：

curl https://api.box.com/2.0/folders/FOLDER_ID \
-H "Authorization: Bearer ACCESS_TOKEN"  \
-H "As-User: USER_ID" \
-d '{"shared_link": {"access": "collaborators"}}' -X PUT

仅通过框 API 将共享链接限制为协作者

Restrict shared links to collaborators only through box API

box-api

boxapiv2