landing.landing.unFavoriteBlock
Удалить из сохраненного списка блоков
Описание
Метод landing.landing.unFavoriteBlock удаляет сохраненную копию блока. Исходный блок на странице не изменяется. При удалении сохраненного блока также удаляются связанные с ним файлы, например пользовательское превью, загруженное для этого блока.
Удалить можно только тот сохраненный блок, который текущий пользователь создал методом landing.landing.favoriteBlock.
Параметры
blockId
integer
обязательный
Идентификатор сохраненной копии блока.
Идентификатор можно получить из результата метода landing.landing.favoriteBlock.
Если передать идентификатор обычного блока страницы или несуществующий идентификатор, метод вернет ошибку
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"blockId": 28619
}' \
"https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.landing.unFavoriteBlock.json"
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"blockId": 28619,
"auth": "**put_access_token_here**"
}' \
"https://**put.your-domain-here**/rest/landing.landing.unFavoriteBlock.json"
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'landing.landing.unFavoriteBlock',
params: {
blockId: 28619,
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Unfavorited block, success:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function unfavoriteBlock() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'landing.landing.unFavoriteBlock',
params: {
blockId: 28619,
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Unfavorited block, success:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', unfavoriteBlock)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.landing.landing.un_favorite_block(
block_id=28619,
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'landing.landing.unFavoriteBlock',
[
'blockId' => 28619,
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Успех: ' . var_export($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Ошибка при удалении блока из списка блоков: ' . $e->getMessage();
}
BX24.callMethod(
'landing.landing.unFavoriteBlock',
{
blockId: 28619
},
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'landing.landing.unFavoriteBlock',
[
'blockId' => 28619,
]
);
if (isset($result['error']))
{
echo 'Ошибка: ' . $result['error_description'];
}
else
{
echo '<pre>';
print_r($result['result']);
echo '</pre>';
}
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "landing.landing.unFavoriteBlock", b24.Params{
"blockId": 28619,
})
if err != nil {
return fmt.Errorf("landing.landing.unFavoriteBlock: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1773978259,
"finish": 1773978259.693505,
"duration": 0.693505048751831,
"processing": 0,
"date_start": "2026-03-20T06:44:19+03:00",
"date_finish": "2026-03-20T06:44:19+03:00",
"operating_reset_at": 1773978859,
"operating": 0
}
}
Возвращаемые данные
result
boolean
Результат удаления сохраненного блока. При успешном выполнении возвращается true
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "ACCESS_DENIED",
"error_description": "Выполнение операции запрещено"
}
| Код | Описание | Значение |
|---|---|---|
MISSING_PARAMS |
Не передан обязательный параметр blockId |
|
TYPE_ERROR |
Передан неверный тип в параметре blockId |
|
BLOCK_NOT_FOUND |
Блок с идентификатором blockId не существует или не является блоком из списка «Мои блоки» |
|
ACCESS_DENIED |
Недостаточно прав для удаления сохраненного блока |

