[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-mail\u002Frecipients\u002Femployees":3,"docs-tabs-mail\u002Frecipients\u002Femployees":6},{"content":4,"lastmod":5},"\n## Поиск сотрудников портала\n\n`POST \u002Fv1\u002Fmail\u002Frecipients\u002Femployees`\n\nИщет сотрудников портала Битрикс24 для подстановки в поле получателей письма. При отсутствии совпадений возвращается пустой массив `items`.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|----------|\n| `query` | string | **да** | Строка поиска по имени или адресу электронной почты сотрудника. Минимум 1 символ |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"query\": \"Мен\"}' \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Frecipients\u002Femployees\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"query\": \"Мен\"}' \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Frecipients\u002Femployees\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Frecipients\u002Femployees',\n  {\n    method: 'POST',\n    headers: {\n      'X-Api-Key': 'YOUR_API_KEY',\n      'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify({ query: 'Мен' }),\n  }\n)\nconst body = await res.json()\nif (!body.success) throw new Error(body.error.code)\nconsole.log(body.data.items)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Frecipients\u002Femployees',\n  {\n    method: 'POST',\n    headers: {\n      'X-Api-Key': 'YOUR_APP_KEY',\n      'Authorization': 'Bearer USER_SESSION_TOKEN',\n      'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify({ query: 'Мен' }),\n  }\n)\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|----------|\n| `success` | boolean | `true` при успешном выполнении |\n| `data.items` | array | Массив найденных сотрудников. Пустой массив при отсутствии совпадений |\n| `data.items[].id` | number | Идентификатор сотрудника |\n| `data.items[].email` | string | Адрес электронной почты |\n| `data.items[].name` | string | Отображаемое имя сотрудника |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"items\": [\n      { \"id\": 1, \"email\": \"manager@example.com\", \"name\": \"Менеджер\" }\n    ]\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — не передан обязательный `query`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Ошибка при валидации объекта запроса\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 422 | `BITRIX_ERROR` | Не передан или пустой `query` — Битрикс24 отклонил запрос |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `mail` |\n| 401 | `TOKEN_MISSING` | Ключ не привязан к порталу Битрикс24 |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или просроченный ключ |\n| 401 | `KEY_INACTIVE` | Ключ деактивирован |\n| 401 | `KEY_EXPIRED` | Срок действия ключа истёк |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Поиск контактов CRM](.\u002Fcontacts.md)\n- [Получатели](\u002Fdocs\u002Fmail\u002Frecipients)\n- [Почта](\u002Fdocs\u002Fmail)\n- [Отправить письмо](\u002Fdocs\u002Fmail\u002Fmessages\u002Fsend)\n- [Ключи и авторизация](\u002Fdocs\u002Fkeys-auth)\n- [Ошибки](\u002Fdocs\u002Ferrors)\n","2026-06-23",{}]