用戶註冊

integer uc_user_register(string username , string password , string email [, integer questionid , string answer])

函數參數
參數 含義
string username 用戶名
string password 密碼
string email 電子郵件
integer questionid 安全提問索引
string answer 安全提問答案
string regip 註冊ip
返回值
含義
integer 大於 0:返回用戶 ID,表示用戶註冊成功
-1:用戶名不合法
-2:包含不允許註冊的詞語
-3:用戶名已經存在
-4:Email 格式有誤
-5:Email 不允許註冊
-6:該 Email 已經被註冊

本接口函數用於新用戶的註冊。用戶名、密碼、Email 為一個用戶在 UCenter 的基本數據,提交後 UCenter 會按照註冊設置和詞語過濾的規則檢測用戶名和 Email 的格式是否正確合法,如果正確則返回註冊後的用戶 ID,否則返回相應的錯誤信息。
用戶註冊示例 (PHP)

用戶登錄

array uc_user_login(string username , string password [, bool isuid , bool checkques , integer questionid , string answer])

函數參數
參數 含義
string username 用戶名 / 用戶 ID / 用戶 E-mail
string password 密碼
bool isuid 是否使用用戶 ID登錄
1:使用用戶 ID登錄
2:使用用戶 E-mail登錄
0:(默認值) 使用用戶名登錄
bool checkques 是否驗證安裝提問
1:驗證安全提問
0:(默認值) 不驗證安全提問
integer questionid 安全提問索引
string answer 安全提問答案
返回值
含義
array integer [0] 大於 0:返回用戶 ID,表示用戶登錄成功
-1:用戶不存在,或者被刪除
-2:密碼錯
-3:安全提問錯
string [1] 用戶名
string [2] 密碼
string [3] Email
bool [4] 用戶名是否重名

本接口函數用於用戶的登錄驗證,用戶名及密碼正確無誤則返回用戶在 UCenter 的基本數據,否則返回相應的錯誤信息。如果應用程序是升級過來的,並且當前登錄用戶和已有用戶重名,那麼返回的數組中 [4] 的值將返回 1。
用戶登錄示例 (PHP)

獲取用戶數據

array uc_get_user(string username [, bool isuid])

函數參數
參數 含義
string username 用戶名
bool isuid 是否使用用戶 ID獲取
1:使用用戶 ID獲取
0:(默認值) 使用用戶名獲取
返回值
含義
array integer [0] 用戶 ID
string [1] 用戶名
string [2] Email

本接口函數用於獲取用戶在 UCenter 的基本數據,如用戶不存在,返回值為 integer 的數值 0。
獲取用戶數據示例 (PHP)

更新用戶資料

integer uc_user_edit(string username , string oldpw , string newpw , string email [, bool ignoreoldpw, integer questionid , string answer])

函數參數
參數 含義
string username 用戶名
string oldpw 舊密碼
string newpw 新密碼,如不修改為空
string email Email,如不修改為空
bool ignoreoldpw 是否忽略舊密碼
1:忽略,更改資料不需要驗證密碼
0:(默認值) 不忽略,更改資料需要驗證密碼
integer questionid 安全提問索引
string answer 安全提問答案
返回值
含義
integer 1:更新成功
0:沒有做任何修改
-1:舊密碼不正確
-4:Email 格式有誤
-5:Email 不允許註冊
-6:該 Email 已經被註冊
-7:沒有做任何修改
-8:該用戶受保護無權限更改

本接口函數用於更新用戶資料。更新資料需驗證用戶的原密碼是否正確,除非指定 ignoreoldpw 為 1。如果只修改 Email 不修改密碼,可讓 newpw 為空;同理如果只修改密碼不修改 Email,可讓 email 為空。
更新用戶資料示例 (PHP)

刪除用戶

integer uc_user_delete(integer/array uid)

函數參數
參數 含義
integer/array uid 用戶名
返回值
含義
integer 1:成功
0:失敗

刪除用戶頭像

integer uc_user_deleteavatar(integer/array uid)

函數參數
參數 含義
integer/array uid 用戶名

同步登錄

string uc_user_synlogin(integer uid)

函數參數
參數 含義
integer uid 用戶 ID
返回值
含義
string 同步登錄的 HTML 代碼

如果當前應用程序在 UCenter 中設置允許同步登錄,那麼本接口函數會通知其他設置了同步登錄的應用程序登錄,把返回的 HTML 輸出在頁面中即可完成對其它應用程序的通知。輸出的 HTML 中包含執行遠程的 javascript 腳本,請讓頁面在此腳本運行完畢後再進行跳轉操作,否則可能會導致無法同步登錄成功。同時要保證同步登錄的正確有效,請保證其他應用程序的 Cookie 域和 Cookie 路徑設置正確。
同步登錄示例 (PHP)

同步退出

string uc_user_synlogout()

返回值
含義
string 同步退出的 HTML 代碼

如果當前應用程序在 UCenter 中設置允許同步登錄,那麼本接口函數會通知其他設置了同步登錄的應用程序退出登錄,把返回的 HTML 輸出在頁面中即可完成其它應用程序的通知。輸出的 HTML 中包含執行遠程的 javascript 腳本,請讓頁面在此腳本運行完畢後再進行跳轉操作,否則可能會導致無法同步退出登錄。同時要保證同步退出登錄的正確有效,請保證其他應用程序的 Cookie 域和 Cookie 路徑設置正確。

檢查 Email 地址

integer uc_user_checkemail(string email)

函數參數
參數 含義
string email Email
返回值
含義
integer 1:成功
-4:Email 格式有誤
-5:Email 不允許註冊
-6:該 Email 已經被註冊

本接口函數用於檢查用戶輸入的 Email 的合法性。
檢查 Email 示例 (PHP)

檢查用戶名

integer uc_user_checkname(string username)

函數參數
參數 含義
string username 用戶名
返回值
含義
integer 1:成功
-1:用戶名不合法
-2:包含要允許註冊的詞語
-3:用戶名已經存在

本接口函數用於檢查用戶輸入的用戶名的合法性。
檢查用戶名示例 (PHP)

添加保護用戶

integer uc_user_addprotected(string/array username , string admin)

函數參數
參數 含義
string/array username 保護用戶名
string admin 操作的管理員
返回值
含義
integer 1:成功
-1:失敗

本接口函數用於添加被保護的用戶。

刪除保護用戶

integer uc_user_deleteprotected(string/array username)

函數參數
參數 含義
string/array username 保護用戶名
返回值
含義
integer 1:成功
-1:失敗

本接口函數用於刪除被保護的用戶。

得到受保護的用戶名列表

integer uc_user_getprotected()

返回值
含義
array 受保護的用戶數據

本接口函數用於獲得被保護的用戶列表。

把重名用戶合併到 UCenter

integer uc_user_merge(string/ oldusername , string newusername, integer uid, string password, string email)

函數參數
參數 含義
string oldusername 老用戶名
string newusername 新用戶名
integer uid 用戶 ID
string password 密碼
string email 電子郵件
返回值
含義
integer 大於 0:返回用戶 ID,表示用戶註冊成功
-1:用戶名不合法
-2:包含不允許註冊的詞語
-3:用戶名已經存在

本接口函數用於把重名的用戶合併到 UCenter。
用戶的合併和用戶重名的處理
如果您的應用程序集成到 UCenter 時包含舊的用戶數據,我們建議您可以採取以下範例的方式把您的用戶導入到 UCenter。
用戶合併示例 (PHP)
本方式的基本流程是:首先,獲取當前 UCenter 中的最大用戶 ID 的值。然後,讀取應用程序自己的用戶表,判讀用戶名是否在 UCenter 重複。如果重複,把重名的用戶名保存到 UCenter 的 mergemembers 表中,不合並這個用戶。如果不重名,則按正常方式導入用戶進行合併。當用戶插入到 mergemembers 表後,用戶在這個應用程序登錄的時候,登錄狀態的返回數組中 [4] 的值將返回 1(請參考上面關於 uc_user_login() 函數的說明)。當登錄狀態返回重名狀態後建議您在應用程序中判讀用戶合法性後進行更名的處理,調用本接口函數。
把重名用戶合併到 UCenter 的示例 (PHP)

移除重名用戶記錄

uc_user_merge_remove(string username)

函數參數
參數 含義
string username 用戶名

本接口函數用於移除重名用戶記錄中的指定記錄,如果應用程序已處理完該重名用戶,可以執行此接口函數。

獲取指定應用的指定用戶積分

integer uc_user_getcredit(integer appid, integer uid, integer credit)

函數參數
參數 含義
integer appid 應用 ID
integer uid 用戶 ID
integer credit 積分編號
返回值
含義
integer 積分

本接口函數用於獲取指定應用的指定用戶積分。