[PHP] 純文本查看 復制代碼
user接口說明:
接口地址:
http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action={接口方法}
實例解析:
1、fetch_uid_by_username,獲取用戶uid,需要傳入?yún)?shù)username=admin
地址:http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action=fetch_uid_by_username&username=admin
返回:{"code":200,"result":"OK","count":2,"data":{"uid":"2","username":"admin"}}
注意:如果是中文用戶名,返回數(shù)據(jù)data中username參數(shù)就會以Unicode編碼方式返回,如需獲取中文用戶名,進行Unicode轉(zhuǎn)換即可;
特別注意:為減少因username中文名字報錯,下面所有涉及用戶接口調(diào)用時,均采用提交uid參數(shù),不接收username參數(shù)。
2、fetch_by_uid,按uid獲取用戶信息,需傳入?yún)?shù)uid=1
地址:http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action=fetch_by_uid&uid=1
返回:{"code":200,"result":"OK","count":8,"data":{"uid":"1","username":"admin","email":"admin@admin.com","groupid":"1",
"grouptitle":"\u7ba1\u7406\u5458","extgroupids":"","credits":"6","regdate":"2018-11-10 09:06:33"}}
3、fetch_by_groupid,按groupid獲取所有會員組用戶信息,需傳入?yún)?shù)groupid=1(會員組id)
地址:http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&op=fetch_by_groupid&groupid=1
返回:{"code":200,"result":"OK","count":1,"data":[{"uid":"1","username":"admin","email":"admin@admin.com","groupid":"1","grouptitle":"\u7ba1\u7406\u5458","extgroupids":""}]}
4、fetch_by_type,按類型獲取用戶組,需傳入?yún)?shù)type,可為空type默認為special,自定義用戶組('system'=>系統(tǒng)用戶組,'special'=>自定義用戶組,'member'=>會員用戶組))
地址:http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action=fetch_by_type&type=special
返回:{"code":200,"result":"OK","count":5,"data":{"16":{"groupid":"16","grouptitle":"\u5b9e\u4e60\u7248\u4e3b"},"17":{"groupid":"17","grouptitle":"\u7f51\u7ad9\u7f16\u8f91"},"18":{"groupid":"18","grouptitle":"\u4fe1\u606f\u76d1\u5bdf\u5458"},"19":{"groupid":"19","grouptitle":"\u5ba1\u6838\u5458"},"20":{"groupid":"20","grouptitle":""}}}
5、user_login,用戶登錄驗證,需傳入?yún)?shù)($username,$password,$questionid,$answer,$sqlbm),
$username :用戶名,必填
$password :用戶密碼,必填
$questionid :用戶問題id(1、2、3、4、5),無設(shè)置安全問題時->此參數(shù)不傳,有安全問題時根據(jù)官方默認提示問題順序為1=母親叫什么名字,后面2、3、4、5以此類推,可為空
$answer :用戶問題答案;設(shè)置了就填,沒設(shè)置就忽略,可為空
$sqlbm :數(shù)據(jù)庫編碼(默認為utf8編碼,值包括:空、utf8、gbk),為了解決GBK數(shù)據(jù)庫中文編碼問題,如果是GBK就傳入?yún)?shù)$sqlbm=gbk,如果是utf8就可以忽略,可為空
地址:http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action=user_login&type=special&username=admin&password=123456
返回:{"code":200,"result":"OK","count":5,"data":{"uid":3,"username":"\u4f60\u597d\u554a","password":"52a832ad3de668c1c34eb56acf3b3c84","questionid":0,"answer":""}}
user接口說明:
6、get_avatar,獲取用戶頭像,需傳入?yún)?shù)($uid,$size),
$uid : 用戶uid;
$size : 頭像大小參數(shù),默認$size=middle,包含('big', 'middle', 'small')) 可為空
地址:http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action=get_avatar&uid=1
返回:
{"code":200,"result":"OK","count":3,"data":{"uid":1,"size":"middle","avatar":"<img src=\"http:\/\/localhost\/uc_server\/avatar.php?uid=1&size=middle\" \/>"}}
admin接口說明:(高級操作)
接口地址:
http://localhost/plugin.php?id=xinxiu_api:admin&key={管理密匙}&action={接口方法}
實例解析:
1、add_credits,對用戶積分增、減、改,需要傳入?yún)?shù)($uid,$coin,$do,$number)都是必傳參數(shù)
$uid : 用戶uid,不能傳用戶名,如需查詢用戶名uid,請使用user接口fetch_uid_by_username方法獲取
$coin :積分編號,對extcredits1積分操作時,填寫1;extcredits1~extcredits8,根據(jù)對應的參數(shù)積分進行填寫(1-8數(shù)字)
$do :操作方法:do=1時為加積分;do=2時為減積分;do=3時為設(shè)置積分(即輸入多少就是多少積分);
$number :積分數(shù),對用戶增、減、改積分的數(shù)量,填入正數(shù),不能輸入負數(shù)及小數(shù)
地址:http://localhost/plugin.php?id=xinxiu_api:admin&key={管理密匙}&action=add_credits&uid=1&coin=2&do=3&number=1000
返回:{"code":200,"result":"OK","count":2,"data":{"uid ":1,"extcredits2":1000}}