Поля события

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

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

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

const { success, data } = await res.json()
console.log('Полей:', Object.keys(data.fields).length)

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

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

{
  "success": true,
  "data": {
    "fields": {
      "id": { "type": "number", "readonly": true, "label": "ID события", "description": "Уникальный идентификатор события календаря." },
      "name": { "type": "string", "readonly": false, "label": "Название", "description": "Название события календаря." },
      "type": { "type": "string", "readonly": false, "label": "Тип календаря", "description": "Тип календаря события: пользовательский, групповой или общий календарь компании." },
      "ownerId": { "type": "number", "readonly": false, "label": "ID владельца календаря", "description": "Идентификатор владельца календаря — сотрудника или рабочей группы." },
      "from": { "type": "datetime", "readonly": false, "label": "Начало события", "description": "Дата и время начала события в формате ISO 8601 со смещением часового пояса." },
      "to": { "type": "datetime", "readonly": false, "label": "Окончание события", "description": "Дата и время окончания события в формате ISO 8601 со смещением часового пояса." },
      "skipTime": { "type": "boolean", "readonly": false, "label": "Событие на весь день", "description": "Признак того, что событие длится весь день без учёта конкретного времени." },
      "durationSeconds": { "type": "number", "readonly": true, "label": "Длительность в секундах", "description": "Продолжительность события в секундах." },
      "importance": { "type": "string", "readonly": false, "label": "Важность", "description": "Уровень важности события: высокий, обычный или низкий." },
      "accessibility": { "type": "string", "readonly": false, "label": "Занятость", "description": "Статус занятости владельца на время события: занят, под вопросом, свободен или отсутствует." },
      "sectionId": { "type": "number", "readonly": false, "label": "ID секции календаря", "description": "Идентификатор секции календаря, в которую записано событие." },
      "attendees": { "type": "array", "readonly": false, "label": "Приглашённые участники", "description": "Массив ID сотрудников, приглашаемых на событие — поле только для записи; в ответе участники возвращаются в attendeeList и attendeesCodes." },
      "rrule": { "type": "object", "readonly": false, "label": "Правило повторения", "description": "Расписание повторения регулярного события: периодичность, интервал, дни недели и условие окончания серии." },
      "crmFields": { "type": "array", "readonly": false, "label": "Элементы CRM", "description": "Элементы CRM, к которым привязано событие, — массив типизированных ссылок: `D_<id>` сделка, `C_<id>` контакт, `L_<id>` лид, `CO_<id>` компания. На создании и обновлении значение обязано быть массивом. Пустой массив снимает все привязки, а отсутствие поля сохраняет уже записанные; очистка работает только на POST и PATCH — в батч-запросе пустой массив отклоняется: `POST /v1/batch` отвечает `INVALID_PARAMS` в `data.errors` под `id` этого вызова, `POST /v1/calendar-events/batch` — `400 BATCH_ITEM_VALIDATION` на весь пакет (имя `INVALID_PARAMS` и индекс элемента приходят внутри `message`). Событие без привязок читается как `[]`. Неизвестный префикс или ссылка на несуществующую запись отклоняются." },
      "dateCreate": { "type": "string", "readonly": true, "label": "Дата создания", "description": "Дата и время создания события в строковом формате, зависящем от региональных настроек портала." },
      "updatedAt": { "type": "string", "readonly": true, "label": "Дата изменения", "description": "Дата и время последнего изменения события в строковом формате, зависящем от региональных настроек портала." },
      "occurrenceIndex": { "type": "number", "readonly": true, "label": "Номер вхождения", "description": "Порядковый номер (с нуля) вхождения в развёрнутой серии повторяющегося события. Повторяющиеся события возвращаются отдельной строкой на каждое вхождение с одним и тем же id — пара (id, occurrenceIndex) однозначно идентифицирует строку." },
      "version": { "type": "number", "readonly": true, "label": "Версия изменений", "description": "Монотонный счётчик изменений на стороне Битрикс24 — растёт при каждом изменении события. Локале-независимый маркер изменения: сравнивайте пары (id, version), чтобы находить обновлённые события без разбора дат." }
    },
    "batch": ["create", "update", "delete"]
  }
}

{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'calendar' scope"
  }
}