report/contact/detail?start-date=2012-01-01&finish-date=2012-12-12&start-index=1&max-results=10
URL
-
{HOST}/services
report/contact/detail?start-date=2012-01-01&finish-date=2012-12-12&start-index=1&max-results=10
支持格式
HTTP 请求方式
认证方式
请求数限制
请求参数
| 字段名称 | 是否必选 | 字段类型 | 说明 |
| 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>chenlei65368@sohu.com</email>
</entry>
<entry>
<email>chenlin65368@sohu.com</email>
</entry>
<entry>
<email>chenli65368@sohu.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/14836869</id>
<updated>2012-02-28T15:12:29.000Z</updated>
<email>d61404001372@163.com</email>
<link href="http://services.unimarketing.com.cn/schedule/11457" rel="related"></link>
<link href="http://services.unimarketing.com.cn/message/14664" rel="related"></link>
<um:sends>1</um:sends>
<um:deliveries>1</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/contact/14836869</id>
<updated>2012-02-29T05:39:16.000Z</updated>
<email>d61404001372@163.com</email>
<link href="http://services.unimarketing.com.cn/schedule/11474" rel="related"></link>
<link href="http://services.unimarketing.com.cn/message/14664" rel="related"></link>
<um:sends>1</um:sends>
<um:deliveries>1</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/contact/14836869</id>
<updated>2012-02-29T08:42:03.000Z</updated>
<email>d61404001372@163.com</email>
<link href="http://services.unimarketing.com.cn/schedule/11488" rel="related"></link>
<link href="http://services.unimarketing.com.cn/message/14709" rel="related"></link>
<um:sends>1</um:sends>
<um:deliveries>1</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/contact/14836869</id>
<updated>2012-03-07T12:00:58.000Z</updated>
<email>d61404001372@163.com</email>
<link href="http://services.unimarketing.com.cn/schedule/11757" rel="related"></link>
<link href="http://services.unimarketing.com.cn/message/14709" rel="related"></link>
<um:sends>1</um:sends>
<um:deliveries>1</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/contact/14836869</id>
<updated>2012-03-07T12:05:06.000Z</updated>
<email>d61404001372@163.com</email>
<link href="http://services.unimarketing.com.cn/schedule/11758" rel="related">
</link><link href="http://services.unimarketing.com.cn/message/14709" rel="related"></link>
<um:sends>1</um:sends>
<um:deliveries>1</um:deliveries>
<um:opens>0</um:opens>
<um:clicks>0</um:clicks>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/schedule/11457</id>
<title type="text">地方</title>
<link href="http://services.unimarketing.com.cn/schedule/11457" rel="self"></link>
<um:subject>的</um:subject>
<um:from>测试账号后注册<unimail201206@qq.com></um:from>
<um:reply>unimail201206@qq.com</um:reply>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/schedule/11474</id>
<title type="text">发送1</title>
<link href="http://services.unimarketing.com.cn/schedule/11474" rel="self"></link>
<um:subject>发送1</um:subject>
<um:from>测试账号后注册<unimail201206@qq.com></um:from>
<um:reply>unimail201206@qq.com</um:reply>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/schedule/11488</id>
<title type="text">223</title>
<link href="http://services.unimarketing.com.cn/schedule/11488" rel="self"></link>
<um:subject>233</um:subject><um:from>测试账号后注册<unimail201206@qq.com></um:from>
<um:reply>unimail201206@qq.com</um:reply>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/schedule/11757</id>
<title type="text">发送公司</title>
<link href="http://services.unimarketing.com.cn/schedule/11757" rel="self"></link>
<um:subject>发送</um:subject>
<um:from>测试账号后注册<unimail201206@qq.com></um:from>
<um:reply>unimail201206@qq.com</um:reply>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/schedule/11758</id>
<title type="text">发送</title>
<link href="http://services.unimarketing.com.cn/schedule/11758" rel="self"></link>
<um:subject>发送</um:subject>
<um:from>测试账号后注册<unimail201206@qq.com></um:from>
<um:reply>unimail201206@qq.com</um:reply>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/message/14664</id>
<title type="text">邮件-1</title>
<updated>2012-02-28T14:26:35.000Z</updated>
<link href="http://services.unimarketing.com.cn/message/邮件-1" rel="self"></link>
<link xml:base="我的邮件" rel="self"></link>
</entry>
<entry>
<id>http://services.unimarketing.com.cn/message/14709</id>
<title type="text">邮件-1-1</title>
<updated>2012-02-29T08:41:31.000Z</updated>
<link href="http://services.unimarketing.com.cn/message/邮件-1-1" rel="self"></link>
<link xml:base="我的邮件" rel="self"></link>
</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.util.ArrayList;
import java.util.List;
import cn.unisoftware.api.client.UnimailClient;
import cn.unisoftware.api.client.utils.AtomConstants;
/**
* @description 查询联系人报表明细
* @author chenlei
* @test 【true】
*/
public class QueryReportContactDetail {
/**
* @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();
emails.add("1720455@qq.com");
emails.add("j156_73gsx@163.com");
emails.add("6661@163.com");
emails.add("chwordtow1@163.com");
String scheduleId="11108";
unimailClient.queryContactsDtail(scheduleId,"2006-03-04", "2014-05-05", emails);
}
}
备注
- 此接口仅仅支持群发邮件的报表数据，如需要触发邮件报表数据请使用Webhooks接口获取报表明细数据进行统计。
