/contact/{contactID}

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

/contact/{contactID}

• 更新联系人信息

URL

• {HOST}/services /contact/{contactID}

支持格式

• XML(Atom)

HTTP 请求方式

• POST

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
contactId	是	Number	联系人ID
email	是	String	联系人Email
title	否	String	标题
um:type	否	String	联系人接收邮件类别(html/text)
um:status	否	String	联系人状态 deleted=已删除 not_confirmed=未确认 activity=活动 unsubscribed=退订 invalid=无效
um:attribute	否	String	联系人属性
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/">
  <email>unimail201168@163.com</email>
  <title></title>
  <um:type>html</um:type>
  <um:status>activity</um:status>
  <um:attribute name="Company">GOOGLE</um:attribute>
  <um:attribute name="Name">liudejian</um:attribute>
  <link href="http://services.unimarketing.com.cn/list/7129" rel="related"></link>
</entry>
					

返回结果

 <?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <id>http://services.unimarketing.com.cn/contact/10180328</id>
  <email>unimail201168@163.com</email>
  <title type="text"></title>
  <um:status>activity</um:status>
</entry>
                        
                           

返回结果说明

字段名称	意义	数据类型	备注
id	联系人ID （10180328为联系人ID）	Number
email	联系人Email	String
title	标题	String
um:status	状态	String	deleted=已删除 not_confirmed=未确认 activity=活动 unsubscribed=退订 invalid=无效

调用示例(Java 示例)

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

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.UnimailClient;
import cn.unisoftware.api.client.model.ContactAttr;
import cn.unisoftware.api.client.model.ContactFieldEnum;
import cn.unisoftware.api.client.model.ContactReq;
import cn.unisoftware.api.client.model.ContactRes;
import cn.unisoftware.api.client.model.ContactStatusEnum;
import cn.unisoftware.api.client.utils.AtomConstants;

/**
 * @description 更新联系人信息
 * @author DJ
 * @test 【true】
 */
public class UpdateContact {
 
	public static void main(String[] args) throws Exception {
		UnimailClient unimailClient = UnimailClient.getClient(false,UnimailClient.AuthMode.BASIC, new String[] {AtomConstants.userName, AtomConstants.userPwd });
 
		ContactReq contactReq = new ContactReq();
		
		contactReq.setId(Long.valueOf(10180328)); //联系人ID【必填】
		contactReq.setEmail("unimail201168@163.com");//【必填】

		contactReq.setStatus(ContactStatusEnum.ACTIVE);
		
		List attrs = new ArrayList();
		ContactAttr ca = new ContactAttr();
		ca.setNameAttr(ContactFieldEnum.COMPANY.getCodeEn()); //公司属性
		ca.setTypeAttr(ContactFieldEnum.COMPANY.getCodeType());
		ca.setValue("GOOGLE");
		attrs.add(ca);
		
		  ca = new ContactAttr();
		ca.setNameAttr(ContactFieldEnum.NAME.getCodeEn()); //名称属性
		ca.setTypeAttr(ContactFieldEnum.NAME.getCodeType());
		ca.setValue("liudejian");
		attrs.add(ca);
		
		
		contactReq.setContactAttrs(attrs);
		
		contactReq.setListId(Long.valueOf(7129));
		
		ContactRes conRes = unimailClient.updateContact(contactReq);
		
		System.out.println(ToStringBuilder.reflectionToString(conRes,ToStringStyle.MULTI_LINE_STYLE));
		
	}

}