/schedule
目录 |
/schedule
- 查询交易邮件报表
URL
- {HOST}/services /report/details/{taskId}?q=domains[126.com,163.com] &start-index=1&max-results=10
支持格式
- XML(Atom)
HTTP 请求方式
- POST
认证方式
请求数限制
- true
请求参数
| 字段名称 | 是否必选 | 字段类型 | 说明 |
|---|---|---|---|
| auth | 是 | String | BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种 |
| alt | 是 | String | 通过该参数,你可以改变返回值的格式,目前支持的返回值格式包括:atom(默认) ,暂不支持json |
| q | 否 | String | 查询条件 例如:q=domains[] |
| start-index | 是 | int | 查询开始值 |
| max-results | 是 | int | 返回最大记录数 |
| link | 否 | Number | 邮件ID(emailId) |
请求字符串
<?xml version="1.0" encoding="UTF-8"?> <entry xmlns="http://www.w3.org/2005/Atom"> <link href="http://services.unimarketing.com.cn/envelope/8899" rel="related"></link> </entry>
返回结果
<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/">
<openSearch:itemsPerPage>10</openSearch:itemsPerPage>
<openSearch:totalResults>4</openSearch:totalResults>
<openSearch:startIndex>1</openSearch:startIndex>
<link xmlns:um="http://www.unimarketing.com.cn/xmlns/"
href="http://services.unimarketing.com.cn/envelope/16948442"
rel="related" um:recipient="unimail2011@163.com"
um:deliveryStatus="queued" um:queueTime="1310620676000"></link>
<link xmlns:um="http://www.unimarketing.com.cn/xmlns/"
href="http://services.unimarketing.com.cn/envelope/16948443"
rel="related" um:recipient="unimail2012@163.com"
um:deliveryStatus="queued" um:queueTime="1310620677000"></link>
</entry>
字段说明
| 字段名称 | 意义 | 数据类型 | 备注 |
|---|---|---|---|
| link | 邮件发送信息 | String |
href ="http://services.unimarketing.com.cn/envelope/16948442" 为 邮件ID um:recipient =联系人Email地址 um:deliveryStatus = 投递状态 um:queueTime = 在队列时间 |
调用示例(Java 示例)
package cn.unisoftware.api.client.example1.transaction;
import java.util.ArrayList;
import java.util.List;
import org.apache.commons.lang.builder.ToStringBuilder;
import org.apache.commons.lang.builder.ToStringStyle;
import cn.unisoftware.api.client.ApiClient;
import cn.unisoftware.api.client.UnimailClient;
import cn.unisoftware.api.client.model.TransactionReport;
import cn.unisoftware.api.client.utils.AtomConstants;
/**
* @description 查询交易邮件报表
* @author DJ
* @date 2001-07-12
*/
public class QueryTransactionMailReport {
public static void main(String[] args) throws Exception {
UnimailClient unimailClient = UnimailClient.getClient(false,ApiClient.AuthMode.BASIC, new String[]{AtomConstants.userName,AtomConstants.userPwd});
// UnimailClient unimailClient = UnimailClient.getClient(false,ApiClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
// UnimailClient unimailClient = UnimailClient.getClient(UnimailClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
Long taskId = 9117l; //【必填】任务ID
String [] domains = new String[]{}; //【选填】按ISP 查询,如:163.com,qq.com
List listmailIds = new ArrayList(); //【选填】按邮件ID 查询
listmailIds.add(Long.valueOf(8899));
TransactionReport tr = unimailClient.queryTransactionReport(taskId, domains, listmailIds, 1, 10);
System.out.println(ToStringBuilder.reflectionToString(tr,ToStringStyle.MULTI_LINE_STYLE));
}
}