灵动创新 Unimarketing 邮件营销 EDM

/contact/{contactID}

目录

/contact/{contactID}

  • 更新联系人信息

URL

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

支持格式

  • XML(Atom)

HTTP 请求方式

  • POST

认证方式

请求数限制

  • 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));
		
	}

}

 
平台介绍
关于我们 | 联系我们 | 行业应用 | 专业术语 | 资源中心 | 隐私声明
© 2022 灵动创新(北京)科技有限公司 - 京ICP备16028763号-1