Ограничьте общие ссылки для соавторов только через API коробки

Я пытаюсь настроить предварительно настроенную папку для пользователей на предприятии, где параметры общего доступа ограничены только соавторами.

Эта функция доступна в веб-интерфейсе в форме свойств папки на вкладке "Безопасность": "Разрешить общие ссылки только соавторам"

API содержимого ящика (v2) позволяет создавать и изменять общие ссылки, это работает, как и ожидалось; но неясно, можем ли мы ограничить параметры общей ссылки.

В документах API для обновления папки: developer.box.com/docs/#folders-update-information-about-a-folder указано, что помимо атрибута shared_link в папке есть атрибут доступа:

доступ: может быть открытым или соавторами. Тип: объект

Я не уверен, каким было бы значение объекта, если бы не строка «сотрудники».

Я пытался:

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, хотя ничего не делают.


person jwscott    schedule 12.01.2015    source источник


Ответы (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
person Greg    schedule 13.01.2015
comment
Грег В документации по папке обновлений перечислены два экземпляра атрибута доступа. Первый: явно является подполем общей ссылки - person jwscott; 13.01.2015
comment
Спасибо, Грег, мне не нужно создавать shared_links, но ваш пост подтверждает мое подозрение, что я не могу ограничить параметры общих ссылок через API. В документации по папке обновления перечислены два экземпляра атрибута доступа. Первый: - доступ Уровень доступа, необходимый для этой общей ссылки. Может быть открыта, компания, сотрудники. Тип: строка явно является подполем общей ссылки. Второе: - доступ можно открыть или заблокировать. Тип: объект Я думаю, это подполе: folder_upload_email Похоже, что API не предоставляет возможность ограничивать параметры общей ссылки. - person jwscott; 13.01.2015