高登+ 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留下你的查詢,問題會直接傳至本人的電郵。