[C#]玩玩Plurk API(Official版)
Plurk的官方正式版的API在近期推出囉,大概看了一下它的文件,簡單的寫了一個小範例,下面分享給大家看看,要了解細節可以到Plurk API的官方網站(http://www.plurk.com/API)去看看,我覺得寫的蠻詳細的。
- 步驟一:取得API的Key
連線到http://www.plurk.com/API,輸入必要的資訊,按下『Issue API key』,然後到你填寫的信箱去收信,馬上就可以獲得Plurk所提供的API key囉。
- 步驟二:閱讀常用功能
Plurk API提供的功能很多,而我們最常使用的大概就是登入、發噗、刪噗等動作,我們可以看看Users與Timeline這部分的功能:
我們以Timeline中的getUnReadPlurks這個API來說明一下這個文件怎麼利用:
- 當我們要使用這個API時如果我們看到reqrires login的字樣,我們就一定要先呼叫API/Users/login的API服務才行,否則就會出現Bad Request的錯誤訊息。
- 呼叫API的方法很簡單,我們以登入來說,只要對http://www.plurk.com/API/Users/login送出Request並帶必要參數api_key=API Key、username、password就好。
- 所以在getUnReadPlurks中,它列了幾個選項:Required parameters:api_key,代表這個參數是一定要傳的;而Optional parameters則代表是選擇性的功能;Successfun return則代表正常執行時回傳的JSON data;Error returns則代表執行失敗時回傳的錯誤訊息。
- 範例一:登入Plurk
透過以下的範例程式,我們就可以登入Plurk。
string API_KEY = "PK9yplgipJO5TKVsxxxxxxxxxxxxxxxxH"; //進行登入的Service URL與參數 string url = "http://www.plurk.com/API/Users/login?api_key=" + API_KEY + "&username=" + "xxxxxxx" + "&password=" + "******"; CookieContainer tCookie = new CookieContainer(); HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url); request.CookieContainer = tCookie; HttpWebResponse response = (HttpWebResponse)request.GetResponse(); StreamReader tReader = new StreamReader(response.GetResponseStream());
我們使用Json.net來解析回傳回來的JSON data就可以發現我們已經正常登入囉,而資料也被截取回來了,可以看到我的fans有54個,而unread plurks有11個。
- 範例二:取得未閱讀的噗
request = (HttpWebRequest)WebRequest.Create(url2); request.CookieContainer = tCookie; response = (HttpWebResponse)request.GetResponse(); tReader = new StreamReader(response.GetResponseStream());
對照:
- 範例三:發噗
request = (HttpWebRequest)WebRequest.Create(url3); request.CookieContainer = tCookie; response = (HttpWebResponse)request.GetResponse(); tReader = new StreamReader(response.GetResponseStream());
結果:
原則上Plurk API的使用難度並不高,稍微玩一下應該就會了,其它的功能有興趣的人可以自己玩玩囉。
游舒帆 (gipi) 探索原力Co-founder,曾任TutorABC協理與鼎新電腦總監,並曾獲選兩屆微軟最有價值專家 ( MVP ),離開職場後創辦探索原力,致力於協助青少年培養面對未來的能力。認為教育與組織育才其實息息相關,都是在為未來儲備能量,2018年起成立為期一年的專題課程《職涯躍升的關鍵24堂課》,為培養台灣未來的領袖而努力。 |