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

Убрать стикер из недавних

DELETE /v1/chats/stickers/recent/:stickerId

Убирает один стикер из списка недавних текущего пользователя. Стикер и его набор не меняются.

Недавние стикеры — последние отправленные пользователем стикеры, не больше 12. Прочитать список можно в поле recentStickers первой страницы списка наборов. Очистить весь список — DELETE /v1/chats/stickers/recent.

Параметры

Параметр Тип Обяз. Описание
stickerId (path) number да ID стикера — recentStickers[].id списка наборов
packId (query) number да ID набора стикера — recentStickers[].packId
packType (query) string да Вид набора стикера — recentStickers[].packType: vendor или custom

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/chats/stickers/recent/5?packId=15&packType=vendor" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/chats/stickers/recent/5?packId=15&packType=vendor" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const sticker = { id: 5, packId: 15, packType: 'vendor' } // элемент recentStickers
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/chats/stickers/recent/${sticker.id}?packId=${sticker.packId}&packType=${sticker.packType}`,
  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } },
)

const { success } = await res.json()
console.log('Убран из недавних:', success)

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

javascript 
const sticker = { id: 5, packId: 15, packType: 'vendor' } // элемент recentStickers
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/chats/stickers/recent/${sticker.id}?packId=${sticker.packId}&packType=${sticker.packType}`,
  {
    method: 'DELETE',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  },
)

const { success } = await res.json()
console.log('Убран из недавних:', success)

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data.result boolean Всегда true, даже если стикера в списке не было

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

JSON 
{
  "success": true,
  "data": { "result": true }
}

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

400 — не передан packId:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "`packId` is required: the id of the pack the sticker belongs to, a positive integer."
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS stickerId или packId не положительное целое, packId или packType не передан, packType не vendor / custom, передан другой параметр или поле тела
401 TOKEN_MISSING API-ключ не имеет настроенных токенов Битрикс24
403 SCOPE_DENIED API-ключ не имеет скоупа im
403 WRITE_BLOCKED_READONLY_KEY Ключ работает только на чтение
404 ENTITY_NOT_FOUND Битрикс24 не нашёл объект. Код портала — в error.b24Code, если он был передан
422 BITRIX_ERROR Битрикс24 вернул ошибку. Код портала — в error.b24Code
502 BITRIX_UNAVAILABLE Битрикс24 недоступен или вернул ошибку сервера

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

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

  • Открытие первой страницы списка наборов оставляет в списке недавних не больше 12 строк — так же, как панель стикеров Битрикс24.

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