Уровни доступа к папке

GET /v1/folders/access-levels

Возвращает id, code и title с портала. ID отличаются на разных порталах: не хардкодьте их. title — на языке портала. Список содержит только read/edit/full; add тоже доступен для выдачи доступа. Для POST shares используйте access read/add/edit/full, а не id из справочника.

Параметры

Параметров нет. Скоуп ключа: disk. READONLY-ключ допускается.

curl — личный ключ

curl "https://vibecode.bitrix24.tech/v1/folders/access-levels" -H "X-Api-Key: YOUR_API_KEY"

curl — ключ приложения

curl "https://vibecode.bitrix24.tech/v1/folders/access-levels" -H "X-Api-Key: YOUR_APP_KEY"

JavaScript — личный ключ

const response = await fetch("https://vibecode.bitrix24.tech/v1/folders/access-levels", { headers: { "X-Api-Key": "YOUR_API_KEY" } });
const data = await response.json();

JavaScript — ключ приложения

const response = await fetch("https://vibecode.bitrix24.tech/v1/folders/access-levels", { headers: { "X-Api-Key": "YOUR_APP_KEY" } });
const data = await response.json();

Ответ

{"success":true,"data":[{"id":79,"code":"disk_access_full","title":"Full access"},{"id":75,"code":"disk_access_edit","title":"Edit"},{"id":71,"code":"disk_access_read","title":"Read"}]}

Поля ответа

Ограничения и ошибки

403 SCOPE_DENIED: нет скоупа disk. Бизнес-отказ Б24: 422 BITRIX_ERROR. Некорректный результат: 422 DISK_ACCESS_LEVELS_REFUSED. Транспортные ошибки — штатные отказы V1.

shares.

Метод Битрикс24: disk.rights.getTasks.