添加好友

bool uc_friend_add(integer uid , integer friendid [, string comment])

函數參數
參數 含義
integer uid 用戶 ID
integer friendid 好友用戶 ID
string comment 備註,可為空
返回值
含義
bool 1:成功
0:失敗

本函數接口用於把 friendid 添加為 uid 的好友。
添加好友示例 (PHP)

刪除好友

integer uc_friend_delete(integer uid , array friendids)

函數參數
參數 含義
integer uid 用戶 ID
array friendids 好友用戶 ID 數組
返回值
含義
integer 被刪除的好友數

本函數接口用於刪除指定用戶的好友。friendids 參數是一個自由 Key 數組類型,如「 array(1, 2, 3, 4, 5 ...) 」,數組的每一個值均代為好友用戶 ID。
刪除好友示例 (PHP)

獲取好友總數

integer uc_friend_totalnum(integer uid [, integer direction])

函數參數
參數 含義
integer uid 用戶 ID
integer direction 0:(默認值) 指定用戶的全部好友
1:正向,指定用戶添加的好友,但沒被對方添加
2:反向,指定用戶被哪些用戶添加為好友,但沒被對方添加
3:雙向,互相添加為好友
返回值
含義
integer 好友數目

本接口函數用於返回指定用戶的好友數。
返回好友數示例 (PHP)

獲取好友列表

array uc_friend_ls(integer uid [, integer page , integer pagesize , integertotalnum , integer direction])

函數參數
參數 含義
integer uid 用戶 ID
integer page 當前頁編號,默認值 1
integer pagesize 每頁最大條目數,默認值 10
integer totalnum 好友總數,默認值 10
integer direction 0:(默認值) 指定用戶的全部好友
1:正向,指定用戶添加的好友,但沒被對方添加
2:反向,指定用戶被哪些用戶添加為好友(粉絲)
3:雙向,互相添加為好友
返回值
含義
array 好友列表數據,其中單條好友數組結構請參看附表

附表:單條好友數組結構

integer ['uid']用戶 ID
integer ['friendid']好友用戶 ID
integer ['direction'] 0:(默認值) 指定用戶的全部好友
1:正向,指定用戶添加的好友,但沒被對方添加
2:反向,指定用戶被哪些用戶添加為好友(粉絲)
3:雙向,互相添加為好友
string ['username']好友用戶名