[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-storage\u002Fobjects\u002Fhead":3,"docs-tabs-storage\u002Fobjects\u002Fhead":6},{"content":4,"lastmod":5},"## Метаданные объекта\n\n`HEAD \u002Fv1\u002Fstorage\u002Fobjects\u002F:key`\n\nВозвращает метаданные объекта в заголовках ответа без тела. Используется для проверки существования объекта и получения его характеристик без загрузки содержимого.\n\n## Параметры\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `key` | string | Ключ объекта. Символы `\u002F` в ключе необходимо кодировать: `users%2F42%2Favatar.png` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -I \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fstorage\u002Fobjects\u002Freports%2F2024%2Fannual.pdf\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -I \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fstorage\u002Fobjects\u002Freports%2F2024%2Fannual.pdf\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fstorage\u002Fobjects\u002Freports%2F2024%2Fannual.pdf',\n  {\n    method: 'HEAD',\n    headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n  }\n)\nconst contentType = res.headers.get('content-type')\nconst size = res.headers.get('content-length')\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fstorage\u002Fobjects\u002Freports%2F2024%2Fannual.pdf',\n  {\n    method: 'HEAD',\n    headers: {\n      'X-Api-Key': 'YOUR_APP_KEY',\n      'Authorization': 'Bearer USER_SESSION_TOKEN',\n    },\n  }\n)\nconst contentType = res.headers.get('content-type')\nconst size = res.headers.get('content-length')\n```\n\n## Ответ\n\nТело ответа отсутствует. Метаданные передаются в заголовках.\n\n| Заголовок | Описание |\n|-----------|---------|\n| `Content-Type` | MIME-тип содержимого объекта |\n| `Content-Length` | Размер объекта в байтах |\n| `ETag` | Хэш содержимого в кавычках |\n\n```\nHTTP\u002F1.1 200 OK\nContent-Type: application\u002Fpdf\nContent-Length: 204800\nETag: \"e3b0c44298fc1c149afbf4c8996fb92\"\n```\n\n## Пример ответа при ошибке\n\n404 — объект не найден:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"STORAGE_OBJECT_NOT_FOUND\",\n    \"message\": \"Object reports\u002F2024\u002Fannual.pdf not found\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | API-ключ не передан |\n| 403 | `STORAGE_SCOPE_REQUIRED` | У API-ключа нет скоупа `vibe:storage` |\n| 404 | `STORAGE_OBJECT_NOT_FOUND` | Объект с указанным ключом не найден |\n| 410 | `STORAGE_OBJECT_DELETED` | Объект был удалён |\n| 502 | `STORAGE_OBJECT_HEAD_FAILED` | Ошибка при обращении к хранилищу |\n| 502 | `STORAGE_OBJECT_MISSING_IN_BUCKET` | Объект найден в базе данных, но отсутствует в хранилище |\n\nПолный список общих ошибок — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Объекты](\u002Fdocs\u002Fstorage\u002Fobjects)\n- [Список объектов](\u002Fdocs\u002Fstorage\u002Fobjects\u002Flist)\n- [Скачать объект](\u002Fdocs\u002Fstorage\u002Fobjects\u002Fget)\n- [Загрузка](\u002Fdocs\u002Fstorage\u002Fupload)\n","2026-06-23",{}]