灵动创新 Unimarketing 邮件营销 EDM

/contact

目录

/contact

  • 查询联系人信息

URL

  • {HOST}/services /contact

支持格式

  • XML(Atom)

HTTP 请求方式

  • GET

认证方式

请求数限制

  • true

请求参数

字段名称 是否必选 字段类型 说明
auth String BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt String 通过该参数,你可以改变返回值的格式,目前支持的返回值格式包括:atom(默认) ,暂不支持json
email String 联系人Email 地址
status String deleted=已删除
not_confirmed=未确认
activity = 活动
unsubscribed = 退订
invalid = 无效地址
listId Number 联系人列表ID

请求字符串

返回结果

<?xml version="1.0" encoding="GBK"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005" xmlns:um="http://www.unimarketing.com.cn/xmlns/" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/">
  <openSearch:itemsPerPage>5</openSearch:itemsPerPage>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:totalResults>15624</openSearch:totalResults>
  <title type="text">搜索 [email=null,status=2,listId=null] 结果</title>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/5222746</id>
    <link href="http://services.unimarketing.com.cn/contact/5222746" rel="self"></link>
    <um:type>html</um:type>
    <um:status>activity</um:status>
    <um:created>2011-06-14 14:21:08</um:created>
    <link href="http://services.unimarketing.com.cn/list/5160" rel="related"></link>
    <link href="http://services.unimarketing.com.cn/list/技术组" rel="related"></link>
    <email>aihdiao819@sina.com</email>
    <um:attribute name="mz" label="名族" type="select" show="true" public="true" sn="0">苗族</um:attribute>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/5222745</id>
    <link href="http://services.unimarketing.com.cn/contact/5222745" rel="self"></link>
    <um:type>html</um:type>
    <um:status>activity</um:status>
    <um:created>2011-06-14 13:34:58</um:created>
    <link href="http://services.unimarketing.com.cn/list/5160" rel="related"></link>
    <link href="http://services.unimarketing.com.cn/list/技术组" rel="related"></link>
    <email>zuiwoxing9@gmail.com</email>
    <um:attribute name="Gender" label="性别" type="radio" show="true" public="true" sn="0">男</um:attribute>
    <um:attribute name="mz" label="名族" type="select" show="true" public="true" sn="0">苗族</um:attribute>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/5222744</id>
    <link href="http://services.unimarketing.com.cn/contact/5222744" rel="self"></link>
    <um:type>html</um:type>
    <um:status>activity</um:status>
    <um:created>2011-06-14 13:26:45</um:created>
    <link href="http://services.unimarketing.com.cn/list/5160" rel="related"></link>
    <link href="http://services.unimarketing.com.cn/list/技术组" rel="related"></link>
    <email>wo@123.com</email>
    <um:attribute name="mz" label="名族" type="select" show="true" public="true" sn="0">苗族</um:attribute>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/5222743</id>
    <updated>2011-06-14T05:17:03.000Z</updated>
    <link href="http://services.unimarketing.com.cn/contact/5222743" rel="self"></link>
    <um:type>html</um:type>
    <um:status>activity</um:status>
    <um:created>2011-06-14 13:15:59</um:created>
    <link href="http://services.unimarketing.com.cn/list/5160" rel="related"></link>
    <link href="http://services.unimarketing.com.cn/list/技术组" rel="related"></link>
    <email>y899@163.com</email>
    <um:attribute name="Gender" label="性别" type="radio" show="true" public="true" sn="0">男</um:attribute>
    <um:attribute name="Name" label="姓名测试" type="text" show="true" public="true" sn="0">666</um:attribute>
  </entry>
  <entry>
    <id>http://services.unimarketing.com.cn/contact/5222742</id>
    <updated>2011-06-14T05:17:49.000Z</updated>
    <link href="http://services.unimarketing.com.cn/contact/5222742" rel="self"></link>
    <um:type>html</um:type>
    <um:status>activity</um:status>
    <um:created>2011-06-14 13:06:05</um:created>
    <link href="http://services.unimarketing.com.cn/list/5160" rel="related"></link>
    <link href="http://services.unimarketing.com.cn/list/技术组" rel="related"></link>
    <email>zui99@gmail.com</email>
    <um:attribute name="Gender" label="性别" type="radio" show="true" public="true" sn="0">男</um:attribute>
    <um:attribute name="Name" label="姓名测试" type="text" show="true" public="true" sn="0">666</um:attribute>
  </entry>
</feed>

 
                                 
                           

字段说明

字段名称 意义 数据类型 备注
openSearch:itemsPerPage 每页显示几条记录 Number
openSearch:totalResults 记录总数 Number
openSearch:startIndex 开始页 Number
title 查询条件 String
id / link 联系人ID Number
updated 更新时间 Date
um:type 联系人接收邮件类别 String
um:status 联系人状态 String deleted=已删除
not_confirmed=未确认
activity=活动
unsubscribed=退订
invalid=无效
um:created 联系人创建时间 String 年-月-日 小时:分:秒
email 联系人Email地址 String
um:attribute 联系人属性 String
list/7137 联系人列表ID (7137 为了联系人列表ID) Number
list/技术小组 联系人列表名称 (技术小组 为 列表名称) String

调用示例(Java 示例)

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

import java.util.concurrent.ConcurrentHashMap;

import org.apache.abdera.model.Feed;

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 QueryContacts {

	/**
	 * GET http://services.unimarketing.com.cn/contact?q=tech&start-index=10&max-results=50
	 * @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});
		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.BASIC, new String[]{AtomConstants.userName,AtomConstants.userPwd});
		ConcurrentHashMap map = new ConcurrentHashMap();
//		q=[email=*,status=0,listId=5289]
		map.put("q", "[email=null,status=2,listId=null]");
		
		map.put("start-index", "1");
		map.put("max-results", "5");
		
		Feed feed = apiClient.queryContacts(map);
	
	    XmlUtil.displayEncodeXml(feed);
	}

}

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