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

Question

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

此功能可在“安全”选项卡下的文件夹属性表单中的web界面中使用：“仅限协作者共享链接”。

box content (v2)允许创建和修改共享链接，这与预期的一样；但尚不清楚是否/如何限制共享链接选项。

文件夹更新的API文档: developers.box.com/docs/#folders-update-information-about-a-folder似乎表明除了shared_link属性之外，文件夹上还有一个access属性：

访问:可以是开放的或协作的。类型:对象

如果不是“协作者”字符串，我不确定对象值是什么。

我试过：

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

两者都返回状态200，尽管它们似乎没有做任何事情。

Answer 1

access字段实际上是shared_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