Uc tag get

出自Discuz! 技术文库

uc_tag_get

array uc_tag_get(string tagname [, array nums])

目录 1 描述 2 参数 3 范例 4 返回值 5 获取标签接口流程

描述

本接口会向用户中心发起一个请求，要求获取用户中心中所有应用的标签数据。如果指定了 totalnum，那么将按照用户中心标签设置中的数字按比例返回相应条目数，如果未指定每个应用将返回所有的 10 条数据。

参数

参数名	类型	是否必需	说明	备注
tagname	string	是	标签名称
nums	array	否	指定每个应用返回多少条数据	数组结构如array('1' => '10', '2' => '15')，键为应用ID, 值为返回的数据条数

范例

$nums = array(
	1 => 3,//ID 为 1 的应用返回 3 条数据
	2 => 5,//ID 为 2 的应用返回 5 条数据
);

$datalist = uc_tag_get($_GET['tagname'], $nums);

foreach($datalist as $tag) {
	echo "<b>$tag[type]:</b><br />";
	foreach($tag['data'] as $data) {
		echo "<a href='$data[url]'>$data[subject]</a><br />$data[extra]";
	}
}

返回值

返回值类型	说明	备注
array	返回标签列表数据	其中单条标签数组结构请查看下方 单条标签数组结构

单条标签数组结构

key	类型	value
data	array	标签内容数组，请参看下方 单条标签内容数组结构
type	integer	应用类型，值为 DISCUZ、SUPESITE、XSPACE、SUPEV、ECSHOP、OTHER

单条标签内容数组结构

key	类型	value
url	string	URL
subject	string	标题
extra	string	扩展数据

获取标签接口流程

接口函数 uc_tag_get() 获取相关标签

->

对于需要更新的标签添加到 UCenter 通知项目

->

API 接口 gettag 获取最新的相关标签数据