/message/{messageID}

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

/message/{messageID}

• 更新邮件

URL

• {HOST}/services /message/{messageID}

支持格式

• 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="GBK"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <title>更新后的邮件</title>
  <um:header align="center"></um:header>
  <um:footer align="center"></um:footer>
  <um:isContainPageHeadFooter>1</um:isContainPageHeadFooter>
  <um:footerName>页头页脚 </um:footerName>
  <um:language>zh_CN</um:language>
  <content type="html" xml:base="http://unimarketing.com.cn/">&lt;![CDATA[&lt;table cellspacing="0" cellpadding="0" width="600" align="#" border="0"&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;p align="left"&gt;此邮件发送至 [$contact.email ] ，我的修改修改的测试邮件——————————————您收到此邮件是因为您向 “杨洋阳” 提供了您的邮件地址。&lt;br /&gt;&lt;br /&gt; “杨洋阳” 尊重您的隐私。若要更新您的信息，请点击 &lt;a href="#"&gt;用户中心&lt;/a&gt; ；如果您不希望再次收到 “杨洋阳” 发来的电子邮件，请点击 &lt;a href="#"&gt;退订&lt;/a&gt; 取消订阅；若您对此邮件内容感兴趣，也可点击 &lt;a href="#"&gt;推荐给好友&lt;/a&gt;将邮件推荐给您的好友一同分享。&lt;/p&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td align="center"&gt;&lt;a href="http://www.unimktg.com" target="_blank"&gt;&lt;img src="http://wwww.unimktg.com/files/logo/821/mflog_821.gif" border="0"&gt;&lt;/a&gt;&lt;br&gt;&lt;a href="#"&gt;退订&lt;/a&gt; |&amp;nbsp; &lt;a href="#"&gt;投诉&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt; ]]&gt;</content>
</entry> 
							

返回结果

<?xml version="1.0" encoding="GBK"?>
<entry xmlns="http://www.w3.org/2005/Atom">
  <id>http://services.unimarketing.com.cn/message/9990</id>
  <title type="text">更新后的邮件</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;

/**
 * @description 更新邮件
 * @author DJ
 * @test 【true】
 */
public class UpdateMail {

	/**
	 * @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});
		Abdera abdera = Abdera.getInstance();
		Entry entry = abdera.newEntry();
	 
		entry.addSimpleExtension(AtomConstants.TITLE, "更新后的邮件");
//		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/");
		
		
		String messageId = "9990"; // 邮件ID，可以先查询
		XmlUtil.displayEncodeXml(entry);
		
		Entry res = apiClient.updateMail(entry, messageId);
       
		XmlUtil.displayEncodeXml(res);
		
		
	}

}