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

Получить статус генерации

GET /v1/sites/ai/status

Получает текущее состояние генерации, запущенной тем же пользователем.

Параметры

Параметр Тип Обяз. По умолч. Описание
Параметрid (query) Типnumber Обяз.да По умолч.— ОписаниеИдентификатор генерации из запуска

Примеры

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

Terminal
curl -X GET "https://vibecode.bitrix24.tech/v1/sites/ai/status?id=11" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal
curl -X GET "https://vibecode.bitrix24.tech/v1/sites/ai/status?id=11" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript
const res = await fetch("https://vibecode.bitrix24.tech/v1/sites/ai/status?id=11", {
  "method": "GET",
  "headers": {
    "X-Api-Key": "YOUR_API_KEY"
  }
});
const result = await res.json();
console.log(result);

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

javascript
const res = await fetch("https://vibecode.bitrix24.tech/v1/sites/ai/status?id=11", {
  "method": "GET",
  "headers": {
    "X-Api-Key": "YOUR_APP_KEY",
    "Authorization": "Bearer USER_SESSION_TOKEN"
  }
});
const result = await res.json();
console.log(result);

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue при успехе
Полеdata Типobject ОписаниеСостояние генерации
Полеdata.id Типnumber ОписаниеИдентификатор генерации
Полеdata.status Типstring Описаниеrunning, completed или failed
Полеdata.siteId Типnumber ОписаниеИдентификатор созданного сайта, до создания 0; сайты
Полеdata.pageId Типnumber ОписаниеИдентификатор созданной страницы, до создания 0; страницы
Полеdata.draftSiteId Типnumber ОписаниеИдентификатор черновика сайта при сбое, иначе 0
Полеdata.draftPageId Типnumber ОписаниеИдентификатор черновика страницы при сбое, иначе 0
Полеdata.message Типstring ОписаниеТекст состояния; для условий используйте status
Полеdata.error Типstring | null ОписаниеПричина сбоя или null
Полеdata.errorDetails Типstring | null ОписаниеПодробность ограничения запросов или null

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

JSON
{
  "success": true,
  "data": {
    "id": 11,
    "status": "running",
    "siteId": 0,
    "pageId": 0,
    "draftSiteId": 0,
    "draftPageId": 0,
    "message": "Сайт генерируется",
    "error": null,
    "errorDetails": null
  }
}

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

JSON
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Не удалось выполнить действие. Проверьте идентификатор",
    "b24Code": "LANDING_AI_SITE_GENERATION_NOT_FOUND"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_PARAMS ОписаниеБитрикс24 отказал в запросе
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key
HTTP401 КодINVALID_API_KEY ОписаниеПлатформа не знает переданную строку ключа
HTTP401 КодTOKEN_MISSING ОписаниеКлюч приложения vibe_app_* передан без заголовка Authorization: Bearer с токеном сессии
HTTP401 КодTOKEN_MISSING ОписаниеУ личного ключа vibe_api_* нет вебхука портала. Причина приходит в error.details
HTTP403 КодSCOPE_DENIED ОписаниеКлючу не выдан скоуп landing
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч запрещает запись
HTTP422 КодBITRIX_ERROR ОписаниеГенерация не существует или принадлежит другому пользователю; b24Code — LANDING_AI_SITE_GENERATION_NOT_FOUND

Общие ошибки.

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

При чтении завершённой или ошибочной генерации ядро может завершить или освободить привязку черновика и учесть отказ модерации. Поэтому получение статуса требует разрешённой записи; ключ READONLY получает 403 WRITE_BLOCKED_READONLY_KEY. Платформа не повторяет запрос статуса после ошибки 5xx.

Вызов выполняется от имени владельца вебхука или пользователя, чей токен OAuth использует ключ.

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