Шаблоны раскладки

Нужен скоуп ключа landing. Каждый маршрут принимает необязательный query scope=KNOWLEDGE, GROUP или MAINPAGE; для обычного сайта он не нужен. Все ID — положительные безопасные целые числа. READONLY-ключ на записи получает отказ до вызова портала.

Стабильный code берётся из XML_ID; title локализован самим порталом. HTML CONTENT не возвращается. areaCount — число областей раскладки.

Операции

• GET /v1/site-templates — landing.template.getlist.

Пример

curl -X GET "https://vibecode.bitrix24.tech/v1/site-templates" -H "X-Api-Key: YOUR_API_KEY"

Ответ

{
  "success": true,
  "data": [
    {
      "id": 7,
      "code": "header_footer",
      "title": "Header and footer",
      "areaCount": 2,
      "active": true,
      "sort": 100
    }
  ]
}

Пустые роли возвращают []; пустые области — {areas:{}}. Запись возвращает сохранённое состояние. Одного true от Битрикс24 недостаточно: несовпадение при перечитывании даёт 422 BITRIX_ERROR.

Ошибки

400 INVALID_PARAMS / INVALID_SCOPE / MISSING_REQUIRED_FIELDS; 401 TOKEN_MISSING; 403 SCOPE_DENIED / BITRIX_ACCESS_DENIED / WRITE_BLOCKED_READONLY_KEY; 404 ENTITY_NOT_FOUND; 409 PORTAL_ADDRESS_CHANGED / LANDING_MODULE_NOT_ENABLED / TEMPLATE_AREAS_BUSY; 422 BITRIX_ERROR; 429 rate limits; 502 / 503 transport failures.