[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-note\u002Fdocuments\u002Fsearch":3,"docs-tabs-note\u002Fdocuments\u002Fsearch":6},{"content":4,"lastmod":5},"\n## Поиск документов\n\n`GET \u002Fv1\u002Fnote\u002Fdocuments\u002Fsearch`\n\nВыполняет полнотекстовый поиск по заголовкам и содержимому документов из баз знаний, доступных ключу, а также документов, к которым выдан прямой доступ. Используйте, чтобы найти документы по ключевым словам, когда идентификатор заранее неизвестен.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `query` (query) | string | да | Поисковый запрос. Минимум 3 символа, максимум 200 |\n| `limit` (query) | integer | нет | Количество результатов, от 1 до 200 |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -G https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fdocuments\u002Fsearch \\\n  --data-urlencode \"query=договор\" \\\n  --data-urlencode \"limit=20\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -G https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fdocuments\u002Fsearch \\\n  --data-urlencode \"query=договор\" \\\n  --data-urlencode \"limit=20\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst params = new URLSearchParams({ query: 'договор', limit: '20' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fdocuments\u002Fsearch?${params}`, {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Найдено:', data)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst params = new URLSearchParams({ query: 'договор', limit: '20' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fnote\u002Fdocuments\u002Fsearch?${params}`, {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив найденных документов |\n| `data[].documentId` | number | Идентификатор документа. Получить документ: `GET \u002Fv1\u002Fnote\u002Fdocuments\u002F:id` |\n| `data[].collectionId` | number | База знаний документа. Список: `GET \u002Fv1\u002Fnote\u002Fcollections` |\n| `data[].title` | string | Заголовок документа |\n| `data[].score` | number | Оценка релевантности совпадения |\n| `data[].snippet` | string | Фрагмент документа с подсветкой совпадений в формате HTML |\n| `data[].sharedAccess` | boolean | `true`, если документ доступен по прямому доступу, а не через членство в базе знаний |\n| `meta.hasMore` | boolean | Есть ли ещё результаты за пределами `limit` |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"documentId\": 11,\n      \"collectionId\": 9,\n      \"title\": \"Глава 1\",\n      \"score\": 0.0984337329864502,\n      \"snippet\": \"\u003Cmark>Глава\u003C\u002Fmark> 1\\nТекст документа\",\n      \"sharedAccess\": false\n    },\n    {\n      \"documentId\": 5,\n      \"collectionId\": 7,\n      \"title\": \"Глава 1 (обновлено)\",\n      \"score\": 0.0984337329864502,\n      \"snippet\": \"\u003Cmark>Глава\u003C\u002Fmark> 1\\nОбновленный текст\",\n      \"sharedAccess\": false\n    }\n  ],\n  \"meta\": {\n    \"hasMore\": false\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — запрос короче 3 символов:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"`query` must be at least 3 characters\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `query` отсутствует или короче 3 символов |\n| 400 | `INVALID_PARAMS` | `limit` вне диапазона от 1 до 200 |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `note` |\n| 401 | `TOKEN_MISSING` | У API-ключа не настроены токены |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Поле `snippet` содержит HTML.** Фрагмент приходит с HTML-разметкой — совпадения обёрнуты в теги `\u003Cmark>…\u003C\u002Fmark>`, а не в разметку Markdown. Приложение, которое выводит `snippet` в интерфейс, обязано очищать этот HTML от небезопасных конструкций перед отображением. Иначе через содержимое документа возможно внедрение стороннего кода в страницу (XSS).\n\n## Смотрите также\n\n- [Получить документ](\u002Fdocs\u002Fnote\u002Fdocuments\u002Fget)\n- [Дерево документов](\u002Fdocs\u002Fnote\u002Fcollections\u002Ftree)\n- [Документы](\u002Fdocs\u002Fnote\u002Fdocuments)\n","2026-07-08",{}]