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

Получить рабочее место

GET /v1/automated-solutions/:id

Возвращает одно цифровое рабочее место по идентификатору вместе с типами смарт-процессов, привязанными к нему.

Параметры

Параметр Тип Обяз. Описание
id (path) number да Идентификатор рабочего места. Список: GET /v1/automated-solutions

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/automated-solutions/9" \
  -H "X-Api-Key: YOUR_API_KEY"

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

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

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

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

const { success, data } = await res.json()
console.log('Рабочее место:', data.title, '— привязанные типы:', data.typeIds)

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

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

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

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Рабочее место
data.id number Идентификатор рабочего места
data.title string Название рабочего места
data.typeIds array Идентификаторы привязанных типов смарт-процессов — поле id типа из GET /v1/smart-processes, а не его entityTypeId. Пустой массив, если типы не привязаны

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

JSON 
{
  "success": true,
  "data": {
    "id": 9,
    "title": "Кадровые процессы",
    "typeIds": [63]
  }
}

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

404 — рабочее место не найдено:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Элемент не найден"
  }
}

Ошибки

HTTP Код Описание
404 ENTITY_NOT_FOUND Рабочего места с таким id нет на портале
400 INVALID_PARAMS id в пути не является целым неотрицательным числом. Запрос отклоняется до обращения к порталу
401 MISSING_API_KEY Заголовок X-Api-Key не передан
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
403 SCOPE_DENIED API-ключ не имеет скоупа crm
429 RATE_LIMITED Превышен лимит запросов: 300 в минуту на портал, все API-ключи портала делят один лимит. Точное значение — в заголовке x-ratelimit-limit (потолок делится на реплики). Повторите после срока из заголовка Retry-After

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

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