/list/{listId}

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

/list/{listId}

• 获取联系人列表信息

URL

• {HOST}/services /list/{listId}

支持格式

• XML(Atom)

HTTP 请求方式

• GET

认证方式

• 1. BASIC
  2. APIKEY
  3. OAUTH
  

请求数限制

• true

请求参数

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

请求字符串

无
							

返回结果

<?xml version="1.0" encoding="GBK"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:um="http://www.unimarketing.com.cn/xmlns/">
  <id>http://services.unimarketing.com.cn/list/5032</id>
  <title type="text">喜欢休闲服装的2</title>
  <subtitle type="text">喜欢休闲服装的2</subtitle>
  <um:activeCount>20</um:activeCount>
  <um:unsubscribeCount>0</um:unsubscribeCount>
  <um:invalidateCount>0</um:invalidateCount>
  <um:unconfirmCount>0</um:unconfirmCount>
  <link href="http://services.unimarketing.com.cn/list/5032" rel="self"></link>
  <link href="http://www.unimarketing.com.cn/contact/喜欢休闲服装的2" rel="alternate"></link>
</entry>
 
                                 
                           

字段说明

字段名称	意义	数据类型	备注
listId	联系人列表标识	Number
um:activeCount	活动联系人总数	Number
um:unsubscribeCount	退订联系人总数	Number
um:invalidateCount	地址无效联系人总数	Number
um:unconfirmCount	未确认联系人数	Number
link (list/5032)	列表ID(其中5032为列表ID)	Number
link (contact/喜欢休闲服装的2)	列表名称(喜欢休闲服装的2 为列表名称)	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 GetContactListInfo {

	/**
	 * @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});
		String listID = "5032";
		Entry res = apiClient.getContactListInfo(listID);
	    XmlUtil.displayEncodeXml(res);
	}
}