report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12

目录 1 report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12&start-index=1&max-results=10 2 URL 3 支持格式 4 HTTP 请求方式 5 认证方式 6 请求数限制 7 请求参数 8 请求字符串 9 返回结果 10 调用实例

report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12

• 查询联系人：汇总报表

URL

• {HOST}/services report/contact/summary?start-date=2012-01-01&finish-date=2012-12-12&start-index=1&max-results=10

支持格式

• XML(Atom)

HTTP 请求方式

• POST

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
start-date	是	String	开始时间
finish-date	是	String	结束时间
start-index	是	Number	开始记录数
max-results	是	Number	最大记录数

请求字符串

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
   <link href="http://services.unimarketing.com.cn/schedule/13801" rel="related"/>
 <entry>
    <email>405593861@qq.com</email>
 </entry>

</feed>

							

返回结果

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
<entry>
<id>http://services.unimarketing.com.cn/contact/15070568</id>
<email>405593861@qq.com</email>
<um:sends>0</um:sends>
<um:deliveries>0</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
</feed>
 

字段说明

字段名称	意义	数据类型	备注
um:sends	发送数	Number
um:deliveries	送达数	Number
um:bounces	弹回数	Number	此次接口不展现这个数据
um:opens	打开数	Number
um:clicks	点击数	Number

调用示例(Java 示例)

 package cn.unisoftware.api.client.example.report;

import java.io.IOException;
import java.io.StringReader;
import java.io.StringWriter;
import java.io.Writer;
import java.util.ArrayList;
import java.util.List;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import org.apache.abdera.model.Feed;
import org.w3c.dom.Document;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;

import com.sun.org.apache.xml.internal.serialize.OutputFormat;
import com.sun.org.apache.xml.internal.serialize.XMLSerializer;


import cn.unisoftware.api.client.UnimailClient;
import cn.unisoftware.api.client.utils.AtomConstants;

/**
 * @description 查询联系人报表汇总
 * @author chenlei
 * @test 【true】
 */
public class QueryContactsSummary {

	/**
	 * @Title: main
	 * @Description:
	 * @param @param args    设定文件
	 * @return void    
	 * @throws Exception 
	 * @throws
	 */
	public static void main(String[] args) throws Exception {
		UnimailClient unimailClient = UnimailClient.getClient(false,UnimailClient.AuthMode.BASIC, new String[] {AtomConstants.userName, AtomConstants.userPwd});
		List emails = new ArrayList();
		String scheduleId="11108";
		Feed feed = unimailClient.queryContactsSummary(scheduleId,"2012-06-25", "2014-05-05", emails);
		System.out.println(format(feed.toString()));
		
		
	}
                  
 

备注

• 此接口仅仅支持群发邮件的报表数据，如需要触发邮件报表数据请使用Webhooks接口获取报表明细数据进行统计。