/v2/Api/SuppressionLists/{ID} POST

Используется для добавления одиночной записи в стоп-лист, определенный параметром ID в URL. При успешном выполнении возвращает «201 Created» HTTP-код и пустое тело ответа.

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

ПараметрТипОписание
apiKeystringВаш API-ключ, необходимый для авторизации. Обязательный.
IDintID стоп-листа. Обязательный как часть адреса (не GET-параметр). Смотрите примеры.
entrystringЗапись для добавления в определенный стоп-лист. Валидная запись может быть:
  • емейл, например, username@domain.com
  • домен, например, domain.com
  • MD5, например, 2c2ba4dc950fd1162c47b08fdcfabe24
Обязательный.

Данный метод игнорирует дубликаты значений в стоп-листе. Вы не получите ошибку, если попробуете добавить емейл (или домен, 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>