Оформление
Удаление записи черного списка
blacklist-remove · POST /api/json/2020-01-01 · Все действия
Удаляет собственную запись. Не отменяет уже созданные сообщения. Глобальные ограничения платформы этим действием не снимаются.
Запрос
| Поле | Тип | Обязательно | Правило |
|---|---|---|---|
id | string | Да | 24 строчных шестнадцатеричных символа; документ должен быть доступен владельцу ключа. |
Иллюстративный запрос (ключ и ID замените собственными):
json
{
"api_key": "00000000-0000-0000-0000-000000000001",
"action": "blacklist-remove",
"data": {
"id": "000000000000000000000001"
}
}Результат
После удаления возвращается только success; поля data нет.
json
{
"success": true
}Отказы
Общие ошибки запроса и доступа применяются ко всем действиям. Неизвестные поля отклоняются; проверяйте success даже при HTTP 200.
| Код | Причина |
|---|---|
BLACKLIST-REMOVE-ID-INVALID-FORMAT | Идентификатор записи черного списка имеет недопустимый формат |
BLACKLIST-REMOVE-ID-INVALID-TYPE | Идентификатор записи черного списка имеет недопустимый тип значения |
BLACKLIST-REMOVE-ID-NOT-FOUND | Запись черного списка с таким идентификатором не найдена |
BLACKLIST-REMOVE-ID-REQUIRED | Идентификатор записи черного списка не указан |