[C#]玩玩Plurk API(Official版)

2009-12-11

38595
0
ASP.NET

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堂課》，為培養台灣未來的領袖而努力。

回首頁