/report/{scheduleID}?type=contact&status={statusName}

目录 1 /report/{scheduleID}?type=contact&status={statusName} 2 URL 3 支持格式 4 HTTP 请求方式 5 认证方式 6 请求数限制 7 请求参数 8 请求字符串 9 返回结果 10 调用实例

/report/{scheduleID}?type=contact&status={statusName}

• 查询发送任务:联系人送达明细报表

URL

• {HOST}/services /report/{scheduleID}?type=contact&status={statusName}

支持格式

• XML(Atom)

HTTP 请求方式

• GET

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
sendTaskId	是	Number	发送任务ID
type	是	String	contact 联系人信息类别
status	是	String	send：发送 derlived：已送达 fail：失败 hard：硬弹回 soft：软弹回 open：邮件打开(交易邮件除外,打开数将小于总数(因为统计数按联系人去重)) click:点击(交易邮件除外,点击数将小于总数(因为统计数按联系人去重)) survey：回答问卷(交易邮件除外,回答问卷将小于总数(因为统计数按联系人去重)) forward：推荐好友(交易邮件除外,推荐好友将小于总数(因为统计数按联系人去重)) unsub：退订 update：更新自身信息 unsubscribe：退订(总计) ispunsubscribe：ISP退订 complaint：投诉(总计) ispcomplaint：ISP投诉
start-index	是	Number	开始页
max-results	是	Number	查询返回最大记录数

请求字符串

无
							

返回结果

 
<?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/" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/">
  <openSearch:itemsPerPage>10</openSearch:itemsPerPage>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:totalResults>3</openSearch:totalResults>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/7937619</id>
    <email>unimail2011@163.com</email>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/7937618</id>
    <email>unimail2012@163.com</email>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/7924364</id>
    <email>dejian.liu@unimarketing.com.cn</email>
  </entry>
</feed>

  

字段说明

字段名称	意义	数据类型	备注
id	联系人ID	Number
email	联系人Email地址	String

调用示例(Java 示例)

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

import org.apache.abdera.model.Feed;

import cn.unisoftware.api.client.ApiClient;
import cn.unisoftware.api.client.utils.AtomConstants;
import cn.unisoftware.api.client.utils.XmlUtil;

/**
 * @description 	获取发送联系人信息
 * @author DJ
 * @test  【true】
 */
public class QuerySendContactInfo {

	/**
	 * 字符串	
	send：发送
	derlived：已送达
	fail：失败
	hard：硬弹回
	soft：软弹回
	open：邮件打开
	click:点击
	survey：回答问卷
	forward：推荐好友
	unsub：退订
	update：更新自身信息
	unsubscribe：退订(总计)
	ispunsubscribe：ISP退订
	complaint：投诉(总计)
	ispcomplaint：ISP投诉

	 * @param args
	 * @throws Exception 
	 */
	public static void main(String[] args) throws Exception {
		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
		String taskId = "7070"; 
		Feed feed = apiClient.querySendContactInfo(taskId, "derlived");
		XmlUtil.displayEncodeXml(feed);

	}

}
  
                  
 

备注

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