Добавить один или несколько доменов в стоп-список
Описание
Добавить один или несколько доменов в стоп-список.
URL-адрес
Метод: POST
https://example.com/api/v1.1/suppresses/domains_add
Параметры запроса
| Параметр | Тип | Пример | Обязательный | Описание |
|---|---|---|---|---|
| token | string | "abcdefghijklmnqrstuvwxyz" | Да | API токен |
| domains | JSON array | ["example.com"] | Да | Список доменов |
| format | string | "json" | Нет | Формат возвращаемых данных (по умолчанию – "json") |
| id | int | 1 | Да | Идентификатор стоп-списка |
Пример запроса
- JSON
- XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"domains": [
"example.com",
"example1.com"
],
"id": 3
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<domains>example1.com</domains>
<domains>example2.com</domains>
<domains>example3.com</domains>
<id>3</id>
</xml>
Пример ответа
- JSON
- XML
- JSON
- XML
{
"error": 0,
"error_text": "Successful operation",
"total_count": 3,
"total_duplicated": 0,
"total_imported": 3,
"total_invalid": 0
}
<xml>
<error>0</error>
<error_text>Successful operation</error_text>
<total_count>3</total_count>
<total_duplicated>0</total_duplicated>
<total_imported>3</total_imported>
<total_invalid>0</total_invalid>
</xml>
<xml>
<error>0</error>
<error_text>Successful operation</error_text>
<total_count>3</total_count>
<total_duplicated>0</total_duplicated>
<total_imported>3</total_imported>
<total_invalid>0</total_invalid>
</xml>
Возвращаемые параметры
| Параметр | Тип | Описание |
|---|---|---|
| error | int | Код ошибки |
| error_text | string | Текст ошибки |
| total_count | int | Всего доменов |
| total_duplicated | int | Домены, добавленные в стоп-список ранее |
| total_imported | int | Доменов добавлено |
| total_updated | int | Доменов обновлено при совпадении |