#Каталог типов полей

GET /v1/items/:entityTypeId/userfields/types

Возвращает список доступных типов пользовательских полей. Список одинаков для всех смарт-процессов и для CRM-сущностей.

#Параметры

Параметр Тип Обяз. Описание
:entityTypeId (path) number да Идентификатор типа смарт-процесса. Источник: `GET /v1/smart-processes` — поле entityTypeId. Значение не влияет на результат — используется только для проверки корректности пути

#Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/items/174/userfields/types" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/items/174/userfields/types" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/items/174/userfields/types',
  {
    headers: { 'X-Api-Key': 'YOUR_API_KEY' },
  }
)
const { success, data } = await res.json()
console.log(`Доступно типов: ${data.length}`)

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/items/174/userfields/types',
  {
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
const { success, data } = await res.json()

#Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data array Массив объектов типов полей
data[].ID string Идентификатор типа — используется как userTypeId в запросах на создание и фильтрации
data[].title string Русское название типа

Полный список типов из ответа API:

ID title
string Строка
integer Целое число
double Число
boolean Да/Нет
enumeration Список
datetime Дата/Время
date Дата
money Деньги
url Ссылка
address Адрес Google карты
file Файл
employee Привязка к пользователю
crm_status Привязка к справочникам CRM
iblock_section Привязка к разделам инф. блоков
iblock_element Привязка к элементам инфоблоков
crm Привязка к элементам CRM

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

JSON 
{
  "success": true,
  "data": [
    { "ID": "string", "title": "Строка" },
    { "ID": "integer", "title": "Целое число" },
    { "ID": "double", "title": "Число" },
    { "ID": "boolean", "title": "Да/Нет" },
    { "ID": "enumeration", "title": "Список" },
    { "ID": "datetime", "title": "Дата/Время" },
    { "ID": "date", "title": "Дата" },
    { "ID": "money", "title": "Деньги" },
    { "ID": "url", "title": "Ссылка" },
    { "ID": "address", "title": "Адрес Google карты" },
    { "ID": "file", "title": "Файл" },
    { "ID": "employee", "title": "Привязка к пользователю" },
    { "ID": "crm_status", "title": "Привязка к справочникам CRM" },
    { "ID": "iblock_section", "title": "Привязка к разделам инф. блоков" },
    { "ID": "iblock_element", "title": "Привязка к элементам инфоблоков" },
    { "ID": "crm", "title": "Привязка к элементам CRM" }
  ]
}

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

400 — некорректный entityTypeId:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_ENTITY_TYPE_ID",
    "message": "entityTypeId must be a positive integer"
  }
}

#Ошибки

HTTP Код Описание
400 INVALID_ENTITY_TYPE_ID :entityTypeId не является положительным целым числом
401 MISSING_API_KEY Отсутствует заголовок X-Api-Key
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
403 SCOPE_DENIED API-ключ не имеет скоупа crm

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

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

Одинаковый результат для всех сущностей. Список типов одинаков для смарт-процессов и для CRM-сущностей. Можно вызвать с любым допустимым entityTypeId — ответ будет идентичен. Значение параметра влияет только на проверку корректности пути.

Не требует скоупа userfieldconfig. В отличие от остальных эндпоинтов /items/:entityTypeId/userfields*, запрос типов работает только со скоупом crm.

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