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

[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囉。

image

 

  • 步驟二:閱讀常用功能

Plurk API提供的功能很多,而我們最常使用的大概就是登入、發噗、刪噗等動作,我們可以看看Users與Timeline這部分的功能:

image

我們以Timeline中的getUnReadPlurks這個API來說明一下這個文件怎麼利用:

image

    1. 當我們要使用這個API時如果我們看到reqrires login的字樣,我們就一定要先呼叫API/Users/login的API服務才行,否則就會出現Bad Request的錯誤訊息。
    2. 呼叫API的方法很簡單,我們以登入來說,只要對http://www.plurk.com/API/Users/login送出Request並帶必要參數api_key=API Key、username、password就好。
    3. 所以在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個。

image

 

  • 範例二:取得未閱讀的噗


        request = (HttpWebRequest)WebRequest.Create(url2);
        request.CookieContainer = tCookie;
        response = (HttpWebResponse)request.GetResponse();
        tReader = new StreamReader(response.GetResponseStream());

image

對照:

image

 

  • 範例三:發噗

        request = (HttpWebRequest)WebRequest.Create(url3);
        request.CookieContainer = tCookie;
        response = (HttpWebResponse)request.GetResponse();
        tReader = new StreamReader(response.GetResponseStream());

結果:

image

 

原則上Plurk API的使用難度並不高,稍微玩一下應該就會了,其它的功能有興趣的人可以自己玩玩囉。

游舒帆 (gipi)

探索原力Co-founder,曾任TutorABC協理與鼎新電腦總監,並曾獲選兩屆微軟最有價值專家 ( MVP ),離開職場後創辦探索原力,致力於協助青少年培養面對未來的能力。認為教育與組織育才其實息息相關,都是在為未來儲備能量,2018年起成立為期一年的專題課程《職涯躍升的關鍵24堂課》,為培養台灣未來的領袖而努力。