/message?q=***&start-index=1&max-results=10

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

/message?q=***&start-index=1&max-results=10

• 查询邮件列表

URL

• {HOST}/services /message?q=***&start-index=1&max-results=10

支持格式

• XML(Atom)

HTTP 请求方式

• GET

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
q	是	String	查询条件(邮件列表名称, * 号代码匹配。)
start-index	是	Number	开始记录数。
max-results	是	Number	返回记录条数

请求字符串

无
							

返回结果

<?xml version="1.0" encoding="GBK"?>
<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>1</openSearch:totalResults>
  <entry>
    <id>http://services.unimarketing.com.cn/message/9949</id>
    <title type="text">哈哈 ，这是测试邮件</title>
    <updated>2011-01-12T03:42:44.000Z</updated>
    <link href="http://services.unimarketing.com.cn/message/哈哈%20，这是测试邮件" rel="self"></link>
    <link href="http://127.0.0.1:8080/uniapi/services/message/哈哈%20，这是测试邮件" rel="alternate"></link>
    <link href="http://services.unimarketing.com.cn/folder/二级目录修改" rel="related"></link>
    <um:header align="right"></um:header>
    <um:footer align="right"></um:footer>
    <content type="html" xml:base="http://unimarketing.com.cn/">&lt;![CDATA[&lt;html&gt;&lt;head&gt;&lt;title&gt;&lt;/title&gt;&lt;meta http-equiv="Content-type" content="text/html;charset=UTF-8" /&gt;&lt;/head&gt;&lt;body&gt;&lt;TABLE WIDTH="100%"&gt;&lt;TR&gt;&lt;TD ALIGN="right" &gt;&lt;table width="600px" border="0" cellspacing="0" cellpadding="0" style="font-size:12px; font-family:Arial,'宋体'; word-wrap: break-word; word-break: normal; line-height:18px;text-align:left" id="divheaderwidthzh" &gt;&lt;tr&gt;&lt;td&gt;如果此邮件无法正常显示，请点击&lt;span id="headerwebversion1" &gt;&amp;nbsp;&lt;a href="#"&gt;网页版本&lt;/a&gt;&lt;/span&gt;&lt;span id="headerunsubscribezh" &gt;&amp;nbsp;|&amp;nbsp;&lt;a href="#"&gt;退订&lt;/a&gt;&lt;/span&gt;&lt;span id="headermanagePreferencezh" style="display:" &gt;&amp;nbsp;|&amp;nbsp;&lt;a href="#"&gt;用户中心&lt;/a&gt;&lt;/span&gt;&lt;span id="headerforwardFriendzh" style="display:" &gt;&amp;nbsp;|&amp;nbsp;&lt;a href="#"&gt;推荐好友&lt;/a&gt;&lt;/span&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;span id="headersafeEmailzh" style="display:"&gt;为确保您能正常收到我们的信息，请把&amp;nbsp;&lt;a href="mailto:unimail2012@163.com"&gt;unimail2012@163.com&lt;/a&gt; 添加为你的联系人。&lt;/span&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;/right&gt;&lt;/TD&gt;&lt;/TR&gt;&lt;TR&gt;&lt;TD&gt;&lt;/TD&gt;&lt;/TR&gt;&lt;TR&gt;&lt;TD&gt;&lt;div width="100%" align=right&gt;&lt;table width="600px" border="0" cellspacing="0" cellpadding="0" style="font-size:12px; font-family:Arial,'宋体'; word-wrap: break-word; word-break: normal; line-height:18px;text-align:left" id="divfooterwidthzh" &gt;&lt;tr&gt;&lt;td&gt;此邮件发送至 [ $contact.email ]，您收到此邮件是因为您向&amp;nbsp;test1202&amp;nbsp;提供了您的邮件地址。&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;span id="unsubscribe" &gt;&lt;a href="#"&gt;退订&lt;/a&gt;&lt;/span&gt;&lt;span id="footermanagePreferencezh" style="display:" &gt;&amp;nbsp;|&amp;nbsp;&lt;a href="#"&gt;用户中心&lt;/a&gt;&lt;/span&gt;&lt;span id="footerforwardFriendzh" style="display:"&gt;&amp;nbsp;|&amp;nbsp;&lt;a href="#"&gt;推荐好友&lt;/a&gt;&lt;/span&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;table&gt;&lt;tr&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt;&lt;tr &gt;&lt;td align="center" &gt;&lt;a href="http://www.unimarketing.com.cn/" target="_blank"&gt;&lt;img src="http://www.unimail.cc/images/delieverbylogo.gif" border="0" type="footlog" /&gt;&lt;/a&gt;&lt;br&gt;&lt;a href='#' style='font-family: Arial,宋体;font-size:12px'&gt;退订&lt;/a&gt; |&amp;nbsp; &lt;a href='#' style='font-family: Arial,宋体;font-size:12px'&gt;投诉&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;br&gt;&lt;/table&gt;&lt;/div&gt;&lt;/TD&gt;&lt;/TR&gt;&lt;/TABLE&gt;&lt;/body&gt;&lt;/html&gt;]]&gt;</content>
    <um:language>zh_CN</um:language>
  </entry>
</feed>

字段说明

字段名称	意义	数据类型	备注
openSearch:itemsPerPage	每页 几条记录	Number
openSearch:startIndex	开始页	Number
openSearch:totalResults	总记录数	Number
id	邮件名称	String
title	邮件ID	Number
updated	更新时间	Date
link	该邮件所属性邮件夹	String
um:header	邮件头属性	String
um:footer	邮件页脚属性	String
content	邮件内容	String
um:language	邮件语言	String

调用示例(Java 示例)

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

import java.util.concurrent.ConcurrentHashMap;

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;

/**
 * 查询邮件列表
 * @author Administrator
 *
 */
public class QueryMailList {

	/**
	 * @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});
        ConcurrentHashMap queryMap = new ConcurrentHashMap();
        queryMap.put("q","*哈哈*");
        queryMap.put("start-index","1");
        queryMap.put("max-results","10");
        
        Feed feed = apiClient.queryMailList(queryMap);
        XmlUtil.displayEncodeXml(feed);
	}

}