Skip to content

Обновление записей в черном списке

Метод blacklist-update предназначен для обновления записей в черном списке.

Параметры запроса

ПараметрТипОбязательныйОписание
idstringДаИдентификатор записи
categorystringДаКатегория черного списка. Допустимые значения: sms_promo sms_service viber *
phonestringДаНомер телефона в международном формате
commentstringНетКомментарий

Пример запроса

json
{
    "api_key": "541eab8c-3e2f-5c47-3278-37206b391dd0",
    "action": "blacklist-update",
    "data": {
        "category": "*",
        "phone": "+79401234567",
        "comment": "Клиент отказался от получения всех типов сообщений"
    }
}

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

ПараметрТипОписание
idstringИдентификатор записи
createddatetimeДата и время создания в формате ISO 8601
updateddatetimeДата и время обновления в формате ISO 8601
categorystringКатегория
phoneintegerНомер телефона
commentintegerКомментарий. Параметр передается только если был указан при добавлении записи

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

json
{
    "success": true,
    "data": {
        "id": "5d59b4c6-19b6-47b4-ba19-0a25ab599f80",
        "created": "2024-01-31T15:10:04+03:00",
        "updated": "2024-02-10T18:43:02+03:00",
        "category": "*",
        "phone": "+79401234567",
        "comment": "Клиент отказался от получения всех типов сообщений"
    }
}

Возможные ошибки

ОшибкаОписание
BLACKLIST-UPDATE-ID-REQUIREDНе указан параметр id
BLACKLIST-UPDATE-ID-INVALID-TYPEПараметр id имеет недопустимый тип
BLACKLIST-UPDATE-ID-INVALID-FORMATПараметр id не соответствует формату
BLACKLIST-UPDATE-ID-NOT-FOUNDЗапись не найдена
BLACKLIST-UPDATE-CATEGORY-REQUIREDНе указан параметр category
BLACKLIST-UPDATE-CATEGORY-INVALID-TYPEПараметр category имеет недопустимый тип
BLACKLIST-UPDATE-CATEGORY-NOT-SUPPORTEDПараметр category имеет недопустимое значение
BLACKLIST-UPDATE-PHONE-REQUIREDНе указан параметр phone
BLACKLIST-UPDATE-PHONE-INVALID-TYPEПараметр phone имеет недопустимый тип
BLACKLIST-UPDATE-PHONE-INVALID-FORMATПараметр phone не соответствует формату
BLACKLIST-UPDATE-PHONE-DUPLICATEНомер телефона уже существует в данной категории
BLACKLIST-UPDATE-COMMENT-INVALID-TYPEПараметр comment имеет недопустимый тип
BLACKLIST-UPDATE-COMMENT-INVALID-FORMATПараметр comment не соответствует формату