获取SignalSpam统计数据


Get SignalSpam statistics 获取SignalSpam统计数据

该接口允许检索SignalSpam的统计数据. 统计数据可使用1-2个限制范围筛选，并且分组查看筛选结果.

请注意，该接口仅适用于开启了SignalSpam统计数据的业务单元.

参数 类型 描述
apiKey string 您的API Key,为了认证身份.必填.
startDate date 起始日期. 选填. 如非指定, 将会采取邮件创建日期. 格式为YYYY-MM-DD.
endDate date 结束日期. 选填. 如未指定，会采用当前日期. 格式为YYYY-MM-DD .
scope string “限制范围”名称. 选填. 如果未指定, 没有任何限制将被应用.

可选的限制范围:
1) Provider 邮件供应商 – (例如Orange, SFR, La Poste)
2) Ip – 发送通道的IP (例如11.22.33.44)
scopeValue string “限制范围” 参数. 如果scope被指定，那么此参数也需填写.
scope2 string “限制范围2”名称.
scopeValue2 string “限制范围2”参数.
grouping string “分组基于…” 参数. 选填.如果未指定, 返回结果将不被分组.

可选的分组参数:

1) Date 日期
2) Month 月份
3) Provider 邮件供应商
4) Ip

示例：

https://api.esv2.com/v2/Api/SignalSpamStatistics?apiKey=YOUR_API_KEY_HERE&startDate=2015-10-12&endDate=2015-10-18&grouping=Datehttps://api.esv2.com/v2/Api/SignalSpamStatistics?apiKey=YOUR_API_KEY_HERE&startDate=2015-10-12&endDate=2015-10-18&scope=Provider&scopeValue=SFR&grouping=Date

应答

应答数据元素:
参数 类型 描述
SignalSpamStatistics array[complex] SignalSpamStatistic元素组成的数组.
ImportReport 子元素：
参数 类型 描述
IsSummaryRow int 如设为true, 将突出汇总行(值为其他行值的总和).*
Date string 日期. 如果分组基于日期，则将被作为返回值.
Month date 月度将以日期范围形式呈现. 如果分组基于月度，则将被作为返回值.
例如: 2010-01-01 : 2010-01-31
Provider int 邮件供应商名称. 如果分组基于邮件供应商, 则将被作为返回值.
Ip int IP通道地址. 如果分组基于IP，则将被作为返回值.
Delivered int 已送达邮件数目.
Complaints int 垃圾邮件投诉数目.
ComplaintsRate int 垃圾邮件投诉比率.
Spamtraps int 击中的蜜罐邮箱数目.

示例

请求:
GET https://api.esv2.com/v2/Api/SignalSpamStatistics?apiKey=YOUR_API_KEY_HERE&startDate=2015-10-12&endDate=2015-10-18&scope=Provider&scopeValue=SFR&grouping=Date HTTP/1.1
OK 应答:
<ApiResponse xmlns:xsd=”http://www.w3.org/2001/XMLSchema” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
 <Data>
  <SignalSpamStatistics>
   <SignalSpamStatistic>
    <IsSummaryRow>true</IsSummaryRow>
    <Date xsi:nil=”true”/>
    <Delivered>0</Delivered>
    <Complaints>1332</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>1110</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-18</Date>
    <Delivered>0</Delivered>
    <Complaints>0</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>0</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-17</Date>
    <Delivered>0</Delivered>
    <Complaints>0</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>0</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-16</Date>
    <Delivered>0</Delivered>
    <Complaints>0</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>0</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-15</Date>
    <Delivered>0</Delivered>
    <Complaints>0</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>0</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-14</Date>
    <Delivered>0</Delivered>
    <Complaints>888</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>333</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-13</Date>
    <Delivered>0</Delivered>
    <Complaints>333</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>222</Spamtraps>
   </SignalSpamStatistic>
   <SignalSpamStatistic>
    <Date>2015-10-12</Date>
    <Delivered>0</Delivered>
    <Complaints>111</Complaints>
    <ComplaintRate>0.00</ComplaintRate>
    <Spamtraps>555</Spamtraps>
   </SignalSpamStatistic>
  </SignalSpamStatistics>
 </Data>
</ApiResponse>