Для AI-агентов: markdown этой страницы — /docs-content/entities/storages/types.md индекс документации — /llms.txt

Типы хранилищ

GET /v1/storages/types

Вызывает disk.storage.getTypes. Скоуп disk. READONLY-ключ разрешён.

Примеры

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

Terminal
curl -X GET 'https://vibecode.bitrix24.tech/v1/storages/types' \
  -H 'X-Api-Key: YOUR_API_KEY'

curl — OAuth-приложение

Terminal
curl -X GET 'https://vibecode.bitrix24.tech/v1/storages/types' \
  -H 'X-Api-Key: YOUR_APP_KEY' \
  -H 'Authorization: Bearer USER_SESSION_TOKEN'

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

javascript
const response = await fetch('https://vibecode.bitrix24.tech/v1/storages/types', {
  method: 'GET',
  headers: {"X-Api-Key": "YOUR_API_KEY"},
})
const result = await response.json()
console.log(result)

JavaScript — OAuth-приложение

javascript
const response = await fetch('https://vibecode.bitrix24.tech/v1/storages/types', {
  method: 'GET',
  headers: {"X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer USER_SESSION_TOKEN"},
})
const result = await response.json()
console.log(result)

Поля ответа

Поле Тип Описание
success boolean Признак успешного запроса
data.items string[] Типы хранилищ из ответа Битрикс24
JSON
{"success":true,"data":{"items":["user","common","group"]}}

data.items — строки, которые вернул Битрикс24, без добавлений платформы Вайбкод. user — личный диск, common — общий, group — диск группы. Эти значения подходят для фильтра entityType у GET /v1/storages.

Список зашит в Битрикс24 и неполный: выдача хранилищ может содержать другие типы, например хранилища приложений. Не считайте справочник исчерпывающим enum.

Ошибки

Пример отказа (403):

JSON
{"success":false,"error":{"code":"SCOPE_DENIED","message":"The API key does not allow the disk scope."}}
HTTP Код Описание
403 SCOPE_DENIED Нет скоупа disk или Битрикс24 отказал в доступе
403 BITRIX_ACCESS_DENIED Нет скоупа disk или Битрикс24 отказал в доступе
422 BITRIX_ERROR Бизнес-отказ Битрикс24 или ответ без списка
422 OPERATION_FAILED Бизнес-отказ Битрикс24 или ответ без списка

Общие отказы — Ошибки.

Смотрите также