/message

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

/message

• 创建邮件

URL

• {HOST}/services /message

支持格式

• XML(Atom)

HTTP 请求方式

• POST

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
title	是	String	邮件名称
um:header	是	String	邮件头属性
um:footer	是	String	邮件脚属性
um:isContainPageHeadFooter	否	String	是否包含页头页脚，默认为包含 1=包含， 2=不包含
um:language	是	String	zh_CN|en_US
um:triggerType	是	String	normal=营销邮件 transaction=交易邮件
um:footerName	否	String	页头名称
content	是	String	邮件内容(必须写在<![CDATA[ 与 ]]>之间)
link	是	String	将邮件创建到指定的邮件夹下

请求字符串

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <title type="text">IP测试F</title>
  <um:header align="center"></um:header>
  <um:footer align="center"></um:footer>
  <um:isContainPageHeadFooter>1</um:isContainPageHeadFooter>
  <um:language>zh_CN</um:language>
  <um:triggerType>normal</um:triggerType>
  <um:footerName>我的测试</um:footerName>
  <content type="text" xml:base="http://www.unimarketing.com.cn/xmlns/">&lt;![CDATA[  IP测试...........ssssss. ]]&gt;</content>
  <link href="http://services.unimarketing.com.cn/folder/技术小组/测试小组" rel="related"></link>
</entry>
 
							

返回结果

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom">
  <id>http://services.unimarketing.com.cn/message/15652</id>
  <title type="text">IP测试E</title>
</entry>
  

字段说明

字段名称	意义	数据类型	备注
ID	邮件ID	Number
title	邮件名称	String

调用示例(Java 示例)

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

import org.apache.abdera.Abdera;
import org.apache.abdera.model.Entry;

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

/**
 * 创建邮件
 * @author DJ
 *
 */
public class CreateMail {


	public static void main(String[] args) throws Exception {
		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
		Abdera abdera = Abdera.getInstance();
		Entry entry = abdera.newEntry();

		entry.addSimpleExtension(AtomConstants.TITLE, "本月好看的书_ME");
		entry.addLink("http://services.unimarketing.com.cn/folder/广告/").setAttributeValue("rel", "related");
		entry.addExtension(AtomConstants.QName_UM_HEADERALIGN).setAttributeValue("align","center");
		entry.addExtension(AtomConstants.QName_UM_FOOTERALIGN).setAttributeValue("align","center");
		entry.addExtension(AtomConstants.QName_UM_LANGUAGE).setText("zh_CN");
		entry.addExtension(AtomConstants.QName_UM_ISCONTAINPAGEHEADFOOTER).setText("2"); //1=包含，2=不包含
		entry.addExtension(AtomConstants.QName_UM_FOOTERNAME).setText("China"); // 【选填】
		entry.setContent(""+
				""+
					""+
					"
此邮件发送至 [$contact.email ] ，您收到此邮件是因为您向 “杨洋阳” 提供了您的邮件地址。

 \"杨洋阳\" 尊重您的隐私。若要更新您的信息，请点击 用户中心 ；如果您不希望再次收到 “杨洋阳” 发来的电子邮件，请点击 退订 取消订阅；若您对此邮件内容感兴趣，也可点击 推荐给好友将邮件推荐给您的好友一同分享。
"+
					""+
					"
退订 |  投诉"+
					""+
				""+
       " ]]>")
       .setAttributeValue("type", "html")
       .setAttributeValue("xml:base", "http://unimarketing.com.cn/");
        XmlUtil.displayEncodeXml(entry);
		Entry res = apiClient.createMail(entry);
		XmlUtil.displayEncodeXml(res);
	}

}