/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 请求方式

• GET

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

字段名称	是否必选	字段类型	说明
auth	是	String	BASIC/APIKEY/ OAUTH 三种认证方式信息中的一种
alt	是	String	通过该参数，你可以改变返回值的格式，目前支持的返回值格式包括：atom(默认) ，暂不支持json
contactId	是	Number	联系人ID

请求字符串

无 
							

返回结果

 <?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/10180327 </id>
   <email>unimail2011@163.com </email>
   <um:type>html </um:type>
   <um:status>activity </um:status>
   <um:created>2012-04-28 16:35:46 </um:created>
   <updated>2012-04-28T08:52:04.000Z </updated>
   <link href="http://services.unimarketing.com.cn/list/7137" rel="related"> </link>
   <link href="http://services.unimarketing.com.cn/list/技术小组" rel="related"> </link>
   <um:attribute name="Name" label="姓名">zhangshan </um:attribute>
   <um:attribute name="Mobile" label="手机">15110087006 </um:attribute>
   <link href="http://services.unimarketing.com.cn/contact/10180327" rel="self"> </link>
 </entry>
					
 
                                 
                           

字段说明

字段名称	意义	数据类型	备注
id	联系人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 org.apache.abdera.model.Entry;

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

	/**
	 * @param args
	 * @throws Exception 
	 */
	public static void main(String[] args) throws Exception {
		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.BASIC, new String[]{AtomConstants.userName,AtomConstants.userPwd});
//		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.APIKEY, new String[]{AtomConstants.apikey,AtomConstants.apisecret});
//		ApiClient apiClient = ApiClient.getApiClient(false,ApiClient.AuthMode.OAUTH, new String[]{AtomConstants.apikey,AtomConstants.apisecret,AtomConstants.accessToken,AtomConstants.tokenSecret});
		String contactID = "5152701"; //通过查询取得
		Entry entry = apiClient.queryContactDetail(contactID);
        XmlUtil.displayEncodeXml(entry);
	}
}