Uc tag get

'''uc_tag_get'''
::array uc_tag_get(string tagname [, array nums])

==描述==

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

==参数==

{| style="background-color:#dfb; border-collapse: collapse; border-spacing: 3px; border:1px solid #8d0; margin: 0px; width: 100%" cellpadding="5"
|-
| '''参数名'''
| '''类型'''
| '''是否必需'''
| '''说明'''
| '''备注'''
|-
| tagname
| string
| 是
| 标签名称
|
|-
| nums
| array
| 否
| 指定每个应用返回多少条数据
| 数组结构如array('1' => '10', '2' => '15')，键为应用ID, 值为返回的数据条数
|}


==范例==
<pre>
$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]";
	}
}
</pre>


==返回值==

{|style="background-color:#feb; border-collapse: collapse; border-spacing: 3px; border:1px solid #fd8; margin: 0px; width: 100%" cellpadding="3"
|-
| '''返回值类型'''
| '''说明'''
| '''备注'''
|-
| array
| 返回标签列表数据
| 其中单条标签数组结构请查看下方 单条标签数组结构
|}

单条标签数组结构
{|style="background-color:#feb; border-collapse: collapse; border-spacing: 3px; border:1px solid #fd8; margin: 0px; width: 100%" cellpadding="3"
|-
| '''key'''
| '''类型'''
| '''value'''
|-
| data
| array
| 标签内容数组，请参看下方 单条标签内容数组结构
|-
| type
| integer
| 应用类型，值为 DISCUZ、SUPESITE、XSPACE、SUPEV、ECSHOP、OTHER
|}

单条标签内容数组结构
{|style="background-color:#feb; border-collapse: collapse; border-spacing: 3px; border:1px solid #fd8; margin: 0px; width: 100%" cellpadding="3"
|-
| '''key'''
| '''类型'''
| '''value'''
|-
| url
| string
| URL
|-
| subject
| string
| 标题
|-
| extra
| string
| 扩展数据
|}


==获取标签接口流程==

{|
|-
| style="border:1px solid #ccc;padding:5px 2px 5px 2px;" | 接口函数 uc_tag_get() 获取相关标签
| ->
| style="border:1px solid #ccc;padding:5px 2px 5px 2px;" | 对于需要更新的标签添加到 UCenter 通知项目
| ->
| style="border:1px solid #ccc;ppadding:5px 2px 5px 2px;" | API 接口 gettag 获取最新的相关标签数据
|}