/contact

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

/contact

• 查询联系人信息

URL

• {HOST}/services /contact

支持格式

• XML(Atom)

HTTP 请求方式

• GET

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

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

}