灵动创新 Unimarketing 邮件营销 EDM

/list

目录

/list

  • 创建联系人列表

URL

  • {HOST}/services /list

支持格式

  • XML(Atom)

HTTP 请求方式

  • POST

认证方式

请求数限制

  • true

请求参数

字段名称 是否必填 字段类型 说明
auth String BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt String 通过该参数,你可以改变返回值的格式,目前支持的返回值格式包括:atom(默认) ,暂不支持json
title String 列表名称(内)
subtitle String 列表名称(外)
um:attribute String 列表属性
name 列表属性英文名称
label 列表属性中文名称
visible=(true|false) 属性是否显示在列表
public =(true|false) 是否公用属性
sn 属性在列表中的显示顺序
type 属性类别(text=文本|checkbox=复选框|radio=单选框|select=列表|textarea=文本域|number=数字类型)
um:option String 在 um:attribute 属性 type=select 时使用该字段.
name 属性英文名称
label 属性中文名称
default (true|false) 是否默认选中

请求字符串

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <title>API测试</title>
  <subtitle>API测试</subtitle>
  <um:attribute name="inCity" label="所在城市" visible="true" public="true" sn="20" type="select">
    <um:option name="sichuang" label="四川" default="true"></um:option>
    <um:option name="beijing" label="北京" default="true"></um:option>
  </um:attribute>
  <um:attribute name="likely" label="爱好" visible="true" public="true" sn="21" type="text"></um:attribute>
</entry>
							

返回结果

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

字段说明

字段名称 意义 数据类型 备注
id 联系人列表ID String http://services.unimarketing.com.cn/list/7128
7128 为列表ID
title 联系人列表名称(内) String
subtitle 联系人列表名称(外) String

调用示例(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.ContactListAttr;
import cn.unisoftware.api.client.model.ContactListReq;
import cn.unisoftware.api.client.model.ContactListRes;
import cn.unisoftware.api.client.model.FieldOption;
import cn.unisoftware.api.client.model.FieldTypeEnum;
import cn.unisoftware.api.client.utils.AtomConstants;

/**
 * @description 创建联系人列表
 * @author DJ
 * @test 【true】
 * 
 */
public class CreateContactList {

	/**
	 * @param args
	 * @throws Exception
	 */
	public static void main(String[] args) throws Exception {

		UnimailClient unimailClient = UnimailClient.getClient(false,
				UnimailClient.AuthMode.BASIC, new String[] {
						AtomConstants.userName, AtomConstants.userPwd });
		ContactListReq contactListReq = new ContactListReq();
		contactListReq.setListName("API测试"); //【必填】
		contactListReq.setListSubName("API测试");//【必填】
		
		List lists = new ArrayList();
		ContactListAttr cla = new ContactListAttr();
//		cla.setNameAttr(ContactFieldEnum.BIRTHDAY.getCodeEn()); //属性 参考 ContactFieldEnum
		cla.setNameAttr("inCity"); //属性 参考 ContactFieldEnum
		cla.setLabelAttr("所在城市");
		cla.setVisibleAttr("true");
		cla.setPublicAttr("true");
		cla.setSnAttr("20");
		cla.setTypeAttr(FieldTypeEnum.SELECT.getCodeEn()); // 下拉框
		
		List listOptions = new ArrayList();
		FieldOption fp = new FieldOption();
		fp.setIsDefault("1");
		fp.setLabel("四川");
		fp.setValue("sichuang");
		listOptions.add(fp);
		
		  fp = new FieldOption();
		fp.setIsDefault("1");
		fp.setLabel("北京");
		fp.setValue("beijing");
		listOptions.add(fp);
		
		cla.setListOptions(listOptions);
		
		
		lists.add(cla);
		  
		cla = new ContactListAttr();
		cla.setNameAttr("likely"); //属性 参考 ContactFieldEnum
		cla.setLabelAttr("爱好");
		cla.setVisibleAttr("true");
		cla.setPublicAttr("true");
		cla.setSnAttr("21");
		cla.setTypeAttr(FieldTypeEnum.TEXT.getCodeEn());  
		
		lists.add(cla);
		
		contactListReq.setListAttr(lists);
		ContactListRes conRes = unimailClient.createContactList(contactListReq);
		System.out.println(ToStringBuilder.reflectionToString(conRes,
				ToStringStyle.MULTI_LINE_STYLE));
	}

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