/v2/Api/SuppressionLists/{ID} POST
Используется для добавления одиночной записи в стоп-лист, определенный параметром ID в URL. При успешном выполнении возвращает «201 Created» HTTP-код и пустое тело ответа.
Параметры запроса:
Параметр | Тип | Описание |
---|---|---|
apiKey | string | Ваш API-ключ, необходимый для авторизации. Обязательный. |
ID | int | ID стоп-листа. Обязательный как часть адреса (не GET-параметр). Смотрите примеры. |
entry | string | Запись для добавления в определенный стоп-лист. Валидная запись может быть:
|
Данный метод игнорирует дубликаты значений в стоп-листе. Вы не получите ошибку, если попробуете добавить емейл (или домен, MD5), который уже находится в стоп-листе. Вы получите ошибку, только если отправите неверную запись.
Примеры:
https://api.esv2.com/v2/Api/SuppressionLists/123?apiKey=Ваш_API_ключ&entry=username%40domain.com https://api.esv2.com/v2/Api/SuppressionLists/123?apiKey=Ваш_API_ключ&entry=2c2ba4dc950fd1162c47b08fdcfabe24
Примеры:
Запрос:
POST https://api.esv2.com/v2/Api/SuppressionLists/123?apiKey=Ваш_API_ключ&entry=username40domain.com HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: application/x-www-form-urlencoded User-Agent: Jakarta Commons-HttpClient/3.1 Host: api.esv2.com Content-Length: 0
ОК ответ:
HTTP/1.1 201 Created Cache-Control: private Server: Microsoft-IIS/7.5 X-AspNetMvc-Version: 2.0 X-AspNet-Version: 2.0.50727 Set-Cookie: TIMEZONE=Central European Standard Time; path=/ X-Powered-By: ASP.NET Date: Wed, 19 Oct 2011 12:10:34 GMT Content-Length: 0
Формат ответа с ошибкой:
HTTP/1.1 400 Bad Request Cache-Control: private Content-Type: text/xml; charset=utf-8 Server: Microsoft-IIS/7.5 X-AspNetMvc-Version: 2.0 X-AspNet-Version: 2.0.50727 Set-Cookie: TIMEZONE=Central European Standard Time; path=/ X-Powered-By: ASP.NET Date: Wed, 19 Oct 2011 12:12:36 GMT Content-Length: 271 <ApiResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <ErrorMessage> <Code>400</Code> <Message>Entry is invalid. Please supply valid email, domain or MD5.</Message> </ErrorMessage> </ApiResponse>