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

Поля рабочей группы

GET /v1/workgroups/fields

Возвращает схему полей рабочей группы и список операций, доступных в пакетных запросах.

Примеры

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

Terminal
curl "https://vibecode.bitrix24.tech/v1/workgroups/fields" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal
curl "https://vibecode.bitrix24.tech/v1/workgroups/fields" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/workgroups/fields', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Полей:', Object.keys(data.fields).length)
console.log('Доступные batch-операции:', data.batch)

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

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/workgroups/fields', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

Подписи полей label и description приходят на русском языке. Заголовками запроса язык не переключается.

Поле Тип Описание
success boolean Всегда true при успехе
data.fields object Объект схемы полей рабочей группы
data.fields.<имя> object Описание одного поля
data.fields.<имя>.type string Тип значения: number, string, boolean или datetime
data.fields.<имя>.readonly boolean true — поле заполняется системой и в запросах на запись не передаётся
data.batch array Список операций сущности, доступных в POST /v1/batch: create, update, delete

Поля рабочей группы

Поле Тип Только чтение Описание
id number да Идентификатор рабочей группы
name string Название
description string Описание
active boolean Активна ли группа
visible boolean Видна ли в общих списках
opened boolean Открыта ли для вступления без приглашения
ownerId number Владелец (ответственный). Список: GET /v1/users
subjectId number Идентификатор темы
subjectName string да Название темы
membersCount number да Количество участников
dateCreate datetime да Дата создания
dateUpdate datetime да Дата последнего обновления
dateActivity datetime да Дата последней активности
archived boolean Помещена ли в архив
isProject boolean Является ли проектом с задачами и сроками
isExtranet boolean Экстранет-группа
keywords string Ключевые слова
siteId string да Идентификатор сайта портала
imageUrl string да URL аватара группы

Доступные include

Эндпоинт GET /v1/workgroups/fields возвращает список доступных include: owner.

Пример использования: Получить рабочую группу.

Подробнее об include: Связанные данные.

Пример ответа

JSON
{
  "success": true,
  "data": {
    "fields": {
      "id": { "type": "number", "readonly": true, "label": "ID", "description": "Идентификатор рабочей группы." },
      "name": { "type": "string", "readonly": false, "label": "Название", "description": "Название рабочей группы." },
      "description": { "type": "string", "readonly": false, "label": "Описание", "description": "Текстовое описание рабочей группы." },
      "active": { "type": "boolean", "readonly": false, "label": "Активна", "description": "Признак того, что группа активна." },
      "visible": { "type": "boolean", "readonly": false, "label": "Видна в списках", "description": "Признак того, что группа отображается в общих списках." },
      "opened": { "type": "boolean", "readonly": false, "label": "Открытая группа", "description": "Признак того, что вступление в группу возможно без приглашения." },
      "ownerId": { "type": "number", "readonly": false, "label": "Владелец", "description": "Идентификатор пользователя, ответственного за группу." },
      "subjectId": { "type": "number", "readonly": false, "label": "ID темы", "description": "Идентификатор темы (направления деятельности) рабочей группы." },
      "subjectName": { "type": "string", "readonly": true, "label": "Название темы", "description": "Название темы, к которой относится рабочая группа." },
      "membersCount": { "type": "number", "readonly": true, "label": "Число участников", "description": "Число участников рабочей группы." },
      "dateCreate": { "type": "datetime", "readonly": true, "label": "Дата создания", "description": "Дата и время создания рабочей группы." },
      "dateUpdate": { "type": "datetime", "readonly": true, "label": "Дата обновления", "description": "Дата и время последнего обновления рабочей группы." },
      "dateActivity": { "type": "datetime", "readonly": true, "label": "Дата активности", "description": "Дата и время последней активности в рабочей группе." },
      "archived": { "type": "boolean", "readonly": false, "label": "В архиве", "description": "Признак того, что группа помещена в архив." },
      "isProject": { "type": "boolean", "readonly": false, "label": "Проект", "description": "Признак того, что группа является проектом с задачами и сроками." },
      "isExtranet": { "type": "boolean", "readonly": false, "label": "Экстранет-группа", "description": "Признак того, что группа относится к экстранету." },
      "keywords": { "type": "string", "readonly": false, "label": "Ключевые слова", "description": "Ключевые слова, связанные с рабочей группой." },
      "siteId": { "type": "string", "readonly": true, "label": "ID сайта", "description": "Идентификатор сайта портала, к которому относится группа." },
      "imageUrl": { "type": "string", "readonly": true, "label": "URL аватара", "description": "Ссылка на изображение аватара рабочей группы." }
    },
    "batch": ["create", "update", "delete"]
  }
}

Пример ответа при ошибке

401 — нет ключа авторизации:

JSON
{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "API key is required"
  }
}

Ошибки

HTTP Код Описание
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 INVALID_API_KEY Ключ не опознан: такой строки на платформе нет
403 SCOPE_DENIED API-ключ не имеет скоупа sonet_group
429 RATE_LIMITED Превышен лимит запросов: 300 в минуту на портал, все API-ключи портала делят один лимит. Точное значение — в заголовке x-ratelimit-limit (потолок делится на реплики). Повторите после срока из заголовка Retry-After

Полный список общих ошибок API — Ошибки.

Известные особенности

  • Список полей не зависит от прав пользователя ключа — возвращается полная схема сущности.
  • Кроме операций, перечисленных в data.batch, в POST /v1/batch для рабочих групп можно вызывать get, list и fields.

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