Системные страницы

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

Типы: mainpage, catalog, personal, cart, order, payment, compare, feedback. Неизвестный тип отклоняется до Битрикс24. PUT требует pageId страницы того же сайта: отсутствующая страница — 404, страница другого сайта — 400. DELETE снимает привязки, сами страницы не удаляет. Удаление отсутствующей одиночной роли — 404. DELETE сайта снимает все его роли. DELETE страницы снимает её роли на всех сайтах и проверяет результат на её собственном сайте. active=true оставляет только активные неудалённые страницы; по умолчанию false возвращает и скрытые. Чтение URL возвращает {url}; отсутствующая привязка — 404, дополнительные query-параметры не принимаются.

Операции

• DELETE /v1/pages/:id/system-pages — landing.syspage.deleteForLanding.

Пример

curl -X DELETE "https://vibecode.bitrix24.tech/v1/pages/42/system-pages" -H "X-Api-Key: YOUR_API_KEY"

Ответ

{
  "success": true,
  "data": [
    {
      "type": "cart",
      "pageId": 614,
      "title": "Cart",
      "deleted": false,
      "active": false
    }
  ]
}

Пустые роли возвращают []; пустые области — {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.

Если до вызова у страницы не было роли на собственном сайте, удаление всё равно передаётся Битрикс24, но V1 отвечает 422 BITRIX_ERROR: проверить роли только на других сайтах он не может. Одного подтверждения Битрикс24 недостаточно для заявления об удалении.