WebApi接口教程文檔！1.02版本

admin

插件特色：

本插件可使站長，無縫對接外部app、web、易語言、C++、PY、GO、java等軟件內嵌api對接接口。
本插件建議只允許站長使用，如需寫更強大的網絡驗證類用戶操作軟件，請自己做好軟件操作限制加密。

聲明：

1、服務器環境必須支持CURL組件，不過一般都支持。
2、本插件在正式使用前，為保證數據庫數據安全，必須要重新逐一測試了解功能后，再正式開放使用。
3、請保護好自己的傳輸密鑰，針對外部軟件調用時，一定要注意加密，防止泄漏。
4、在使用前請認真閱讀操作文檔，只對插件功能負責，由于其他原因造成的信息泄露與本站無關。

功能說明：

1、在參數設置中，傳輸密鑰，可設置3個，每一個密鑰都可以調用全部接口；
2、本接口可同時接收GET、POST參數傳輸，返回結果JSON形式；
3、本插件對方法、參數入口都進行了嚴格過濾，參數不齊全、方法不對都返回錯誤提示信息；
4、本插件嚴格遵循官方安全過濾，極大提高安全性，防止惡意注入;
5、本插件適用discuz所有數據庫增、減、改、查，如需定制請聯系客服。

[PHP] 純文本查看 復制代碼

接口形式解析：
接口地址：http://localhost/plugin.php?id=xinxiu_api:{接口名稱}&key={傳輸密匙}或{管理密鑰}&action={接口方法}&參數1=值&參數2=值……
--------------------------------------------------------------
接口名稱：每個新增一個接口就會產生一個，這個在下面接口教程內有分類；
傳輸密鑰：插件后臺三個傳輸密鑰，只要其中一個就可以；
管理密鑰：與傳輸密鑰不能同時使用，管理密鑰在后臺進行特殊操作時使用，沒有就忽略；
接口方法：每個接口文件下都會有多個接口方法，具體看教程；
參數=值：根據接口方法的參數要求，進行傳值，可使用GET或POST方式。

返回數據：
{"code":200,"result":"OK","count":2,"data":{"uid":"1","username":"admin"}}
--------------------------------------------------------------
code:返回狀態碼，正常為200；
result：返回狀態碼對應的信息；
count：返回data數組中的數量；
data:返回獲得值。具體對應參數請到[url=http://m.5566wy.com/forum.php?mod=viewthread&tid=49&page=1]http://m.5566wy.com/forum.php?mod=viewthread&tid=49&page=1[/url]查閱！

[PHP] 純文本查看 復制代碼

user接口說明：
接口地址：
http://localhost/plugin.php?id=xinxiu_api:user&key={傳輸密匙}&action={接口方法}

實例解析：
1、fetch_uid_by_username，獲取用戶uid，需要傳入參數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"}}

注意：如果是中文用戶名，返回數據data中username參數就會以Unicode編碼方式返回，如需獲取中文用戶名，進行Unicode轉換即可；
特別注意：為減少因username中文名字報錯，下面所有涉及用戶接口調用時，均采用提交uid參數，不接收username參數。

2、fetch_by_uid，按uid獲取用戶信息，需傳入參數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獲取所有會員組用戶信息，需傳入參數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，按類型獲取用戶組，需傳入參數type，可為空type默認為special，自定義用戶組（'system'=>系統用戶組,'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，用戶登錄驗證，需傳入參數($username,$password,$questionid,$answer,$sqlbm)，
$username ：用戶名，必填
$password ：用戶密碼，必填
$questionid ：用戶問題id（1、2、3、4、5），無設置安全問題時->此參數不傳，有安全問題時根據官方默認提示問題順序為1=母親叫什么名字，后面2、3、4、5以此類推，可為空
$answer ：用戶問題答案；設置了就填，沒設置就忽略，可為空
$sqlbm ：數據庫編碼（默認為utf8編碼，值包括：空、utf8、gbk），為了解決GBK數據庫中文編碼問題，如果是GBK就傳入參數$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，獲取用戶頭像，需傳入參數($uid,$size)，
$uid : 用戶uid；
$size : 頭像大小參數，默認$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，對用戶積分增、減、改，需要傳入參數($uid,$coin,$do,$number)都是必傳參數
$uid : 用戶uid，不能傳用戶名，如需查詢用戶名uid，請使用user接口fetch_uid_by_username方法獲取
$coin ：積分編號，對extcredits1積分操作時，填寫1；extcredits1~extcredits8，根據對應的參數積分進行填寫（1-8數字）
$do ：操作方法：do=1時為加積分；do=2時為減積分；do=3時為設置積分（即輸入多少就是多少積分）；
$number ：積分數，對用戶增、減、改積分的數量，填入正數，不能輸入負數及小數
地址：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}}

更多內置接口正在開發中。如果你有特殊接口可與客服聯系。
除了discuz內置數據接口，本人承接其他插件數據接口開發。

版本下載頁面：http://m.5566wy.com/forum.php?mod=viewthread&tid=50

jackhhh

這個能接受post請求么? 比如我想做一個發帖的接口