高登+ API 正式推出,開發者可以透過API來存取高登+的資料,以進一步改善瀏覽高登討論區的體驗。
API位置︰http://hkg.westkit.net/api.php
使用API的方法十分簡單,只需向這個網址發出http request,參數用網址傳送就可以了。例如︰http://hkg.westkit.net/api.php?format=php&action=getUIDByUsername&username=alex
參數︰
format=
format=json : 回應的資料將為json格式
(如format=json&jsoncallback=callback,回應的資料將會是一個js function,並且名為callback)
format=php : 回應的資料將為php serialize的格式
注意:action=search,getChannels,getPosts,getPost 只有php format
action=
action=getScore : 拿取主題相應的分數,以按用家投票重新排列文章
額外參數:
t=123,456 : 主題的id,以逗號分隔
action=getUIDByUsername : 按用戶名稱拿取相應的UID(注︰是高登+的用戶,不是高登討論區的用戶)
額外參數:
username=abc : 用戶名稱
錯誤:
code=01 : 使用了空白的用戶名
code=02 : 用戶不存在
action=deleteBookmark : 刪除一個bookmark
額外參數:
id=123 : bookmark的id
uid=456 : 高登+用戶id
password=789 : 高登+用戶密碼
錯誤:
code=08 : 用戶不存在
action=getBookmarks : 取回某高登+用戶的bookmark
額外參數:
uid=123 : 高登+用戶id
username=abc : 高登+用戶名稱,如有高登+用戶id就不需要用這個參數
password=456 : 高登+用戶密碼
start=0 : 要從何開始取bookmark
limit=0 : 要拿取的bookmark數量
錯誤:
code=00 : 用戶不存在
code=06 : 未通過驗証
action=getBanList : 拿取用戶ban了的id
額外參數:
uid=123 : 高登+用戶id
username=abc : 高登+用戶名稱,如有高登+用戶id就不需要用這個參數
password=456 : 高登+用戶密碼
錯誤:
code=00 : 用戶不存在
code=06 : 未通過驗証
action=ban : ban某個高登用戶
額外參數:
uid=123 : 高登+用戶id
username=abc : 高登+用戶名稱,如有高登+用戶id就不需要用這個參數
password=456 : 高登+用戶密碼
userid=789 : 要ban的高登討論區用戶id
錯誤:
code=00 : 用戶不存在
code=06 : 未通過驗証
action=unban : unban某個高登用戶
額外參數:
uid=123 : 高登+用戶id
username=abc : 高登+用戶名稱,如有高登+用戶id就不需要用這個參數
password=456 : 高登+用戶密碼
userid=789 : 要unban的高登討論區用戶id
錯誤:
code=00 : 用戶不存在
code=06 : 未通過驗証
action=createUser : 創造一個高登+用戶帳號
額外參數:
username=abc : 高登+用戶名稱
password=123 : 高登+用戶密碼
錯誤:
code=02 : 用戶名已被使用
action=authorizeUser : 驗証某高登+用戶帳號
額外參數:
username=abc : 高登+用戶名稱
password=123 : 高登+用戶密碼
action=addBookmark : 新增一個bookmark
額外參數:
uid=123 : 高登+用戶id
username=abc : 高登+用戶名稱,如有高登+用戶id就不需要用這個參數
password=456 : 高登+用戶密碼
pid=789 : 高登討論區的主題id
page=1 : 要bookmark的主題頁數
title=XXX : 要bookmark的主題題目
錯誤:
code=03 : 沒有指定用戶id或用戶名
code=04 : 沒有指定主題id
code=05 : 未通過驗証
code=07 : 曾經新增此bookmark
另外,要為某個高登主題投票,可以向http://hkg.westkit.net/?p=gt&id=POSTID (加分) 或 http://hkg.westkit.net/?p=bt&id=POSTID (扣分) 發出request
不明白的可以去http://www.westkit.net/contact.php留下你的查詢,問題會直接傳至本人的電郵。